Provider::Commit-Methode (provider.h)
[Die Provider-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]
Die Commit-Methode wird verwendet, um eine instance an WMI zu senden. Diese Methode ist eine Hilfsfunktion und sollte nicht überschrieben werden.
Syntax
HRESULT Commit(
CInstance *pInstance,
bool bCache
);
Parameter
pInstance
Zeiger auf die instance, die von WMI gespeichert werden soll.
bCache
Gibt an, ob ein Cache implementiert ist. Dieser Wert muss in der aktuellen Version des Anbieterframeworks auf FALSE festgelegt werden.
Rückgabewert
Verwenden Sie die Makros SUCCEEDED oder FAILED für das zurückgegebene HRESULT, um zu bestimmen, ob die Methode erfolgreich war.
Hinweise
Wenn der Client die Abfrage abbricht, gibt die Commit-Methode einen Fehler zurück. Ein Anbieterautor kann diesen Fakt verwenden, um eine Enumeration zu beenden.
Außerdem ruft diese Methode CInstance::Release für den pInstance-Zeiger auf. Daher muss der Frameworkanbieter darauf achten, CInstance::Release nicht erneut aufzurufen. Dies bedeutet, dass ein intelligenter pInstance-Zeiger mit dieser Methode nicht kompatibel ist, da der intelligente Zeiger CInstance::Release in seinem Destruktor aufruft.
Diese Methode sollte nur verwendet werden, wenn der Frameworkanbieter CInstance::Release nicht separat für den pInstance-Zeiger aufruft und wenn der pInstance-Zeiger kein intelligenter Zeiger ist und nie sein wird.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | provider.h (schließen Sie FwCommon.h ein) |
Bibliothek | FrameDyn.lib |
DLL | FrameDynOS.dll; FrameDyn.dll |