Provider::Commit-Methode (provider.h)

  • Artikel

[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