IWbemConfigureRefresher::AddObjectByPath-Methode (wbemcli.h)

Artikel
03/03/2024

Die IWbemConfigureRefresher::AddObjectByPath-Methode fügt einem Refresher ein Objekt hinzu, indem sie einen Objektpfad angibt.

Syntax

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parameter

[in] pNamespace

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

[in] wszPath

Konstante, NULL-beendete Zeichenfolge mit 16-Bit-Unicode-Zeichen, die den Objektpfad des Objekts enthält, das Sie der Aktualisierung hinzufügen.

[in] lFlags

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

[in] pContext

Normalerweise NULL; andernfalls ein Zeiger auf ein IWbemContext-Objekt , das von mindestens einem dynamischen Klassenanbieter benötigt wird. Die Werte im Kontextobjekt müssen in der spezifischen Anbieterdokumentation angegeben werden. Weitere Informationen zu diesem Parameter finden Sie unter Tätigen von Aufrufen von 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 erforderlich ist.

[out] plId

Zeiger auf eine ganze Zahl, die vom Anbieter zurückgegeben wird, die das aktualisierungsfähige Objekt eindeutig identifiziert.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Hinweise

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

Hinweis 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 erforderlich ist.

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