Provider::P utInstance(IWbemClassObject*,long,MethodContext*)-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 PutInstance-Methode aktualisiert eine instance.

Syntax

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

Parameter

pInst

TBD

lFlags

Bitmaske von Flags mit Informationen zum Aktualisierungsvorgang. Dies ist der vom Client in der IWbemServices::P utInstance-Methode angegebene Wert.

Das folgende Flag wird von WMI behandelt (und herausgefiltert):

• WBEM_FLAG_RETURN_IMMEDIATELY

• WBEM_FLAG_CREATE_ONLY
• WBEM_FLAG_CREATE_OR_UPDATE
• WBEM_FLAG_UPDATE_ONLY

pContext

TBD

Rückgabewert

Die Standardframeworkanbieterimplementierung dieser Methode gibt WBEM_E_PROVIDER_NOT_CAPABLE an die aufrufende Methode zurück. Die IWbemServices::P utInstance-Methode listet die gängigsten Rückgabewerte auf, obwohl Sie auswählen können, ob sie beliebigen COM-Rückgabecode zurückgeben möchten.

Hinweise

WMI ruft PutInstance auf, wenn ein Client IWbemServices::P utInstance für Ihre Klasse aufruft. Sie müssen PutInstance implementieren, wenn Ihr Frameworkanbieter Instanzen aktualisiert. In der folgenden Liste wird eine gängige Implementierung von PutInstance beschrieben:

1. Untersuchen Sie die vom Client übergebenen Schlüsseleigenschaften mit den Get-Methoden für CInstance, z. B. CInstance::GetCHString.

   Ihre Implementierung sollte bestimmen, ob Ihr Anbieter die vom Client angeforderten Änderungen unterstützt.

2. Erstellen oder aktualisieren Sie das entsprechende verwaltete Objekt nach Bedarf.
3. Gibt den entsprechenden Rückgabewert zurück.

   Wenn Ihr Anbieter die vom Client angeforderten Änderungen nicht unterstützt, sollten Sie einen entsprechenden Fehlercode zurückgeben. Eine vollständige Liste der gültigen Fehlercodes finden Sie unter IWbemServices::P utInstance.

Anforderungen