IWbemConfigureRefresher::AddObjectByTemplate-Methode (wbemcli.h)

Artikel
08/27/2023

Mit der IWbemConfigureRefresher::AddObjectByTemplate-Methode können Sie ein Objekt, das Sie aktualisieren möchten, zu einer Aktualisierung hinzufügen, indem Sie eine IWbemClassObject-instance Vorlage angeben. Verwenden Sie diese Methode, wenn es schwierig ist, einen Objektpfad für ein Objekt zu erstellen, das einer Aktualisierung hinzugefügt werden soll.

Hinweis Die wichtigsten Eigenschaften des instance-Objekts müssen ausgefüllt werden, bevor Sie die AddObjectByTemplate-Methode aufrufen können.

Syntax

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parameter

pNamespace

Ein IWbemServices-Zeiger zurück in die Windows-Verwaltung, die jede Anforderung des Anbieters verarbeiten kann. Der Anbieter sollte AddRef für diesen Zeiger aufrufen, wenn er während der Ausführung zurück in die Windows-Verwaltung ruft.

[in] pTemplate

Zeiger auf ein IWbemClassObject-Objekt, das die instance-Vorlage enthält.

[in] lFlags

Bitmaske von Flags, die das Verhalten dieser Methode ändern. Wenn dieser Parameter auf WBEM_FLAG_USE_AMENDED_QUALIFIERS festgelegt ist, enthält der zurückgegebene instance lokalisierte Qualifizierer, sofern verfügbar.

[in] pContext

In der Regel NULL; Andernfalls ein Zeiger auf ein IWbemContext-Objekt , das von einem oder mehreren dynamischen Klassenanbietern benötigt wird. Die Werte im Kontextobjekt müssen in der spezifischen Anbieterdokumentation angegeben werden. Weitere Informationen zu diesem Parameter finden Sie unter Ausführen von Aufrufen an WMI.

[out] ppRefreshable

Zeiger, um den Verweis auf ein IWbemClassObject-Objekt zu enthalten, das das aktualisierbare instance -Objekt enthält. Der Client muss Release für das zurückgegebene Objekt aufrufen, wenn es nicht mehr benötigt wird.

[out] plId

Zeiger auf eine ganze Zahl, die vom Anbieter zurückgegeben wird, die dieses aktualisierbare Objekt eindeutig identifiziert.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Hinweise

Die angegebene instance muss ein gültiges Objekt angeben, das vom High-Performance Anbieter bereitgestellt wird. Das zurückgegebene Objekt darf vom Client nicht geändert werden, während ein Aktualisierungsvorgang ausgeführt wird. Der zurückgegebene Bezeichner kann von der Remove-Funktion verwendet werden, um das Objekt zu entfernen.

Es ist nicht erforderlich, dass der Benutzer hinzugefügte Objekte explizit entfernt. Der Client muss Release für das zurückgegebene Objekt aufrufen, wenn es nicht mehr benötigt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib

Weitere Informationen

Zugreifen auf Leistungsdaten in C++

IWbemConfigureRefresher

Umwandeln eines Instanzanbieters in einen Hochleistungsanbieter

Leistungsindikator-Provider

Freigeben über