Provider::P utInstance(constCInstance&,long)-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(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Parameter

[ref] newInstance

Instanz, die aktualisiert wird.

lFlags

Bitmaske von Flags mit Informationen zum Updatevorgang. Dies ist der Wert, der vom Client in der IWbemServices::P utInstance-Methode angegeben wird.

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

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 einen beliebigen COM-Rückgabecode zurückgeben können.

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 allgemeine 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 nach Bedarf das entsprechende verwaltete Objekt.
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