IWbemConfigureRefresher::AddEnum-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemConfigureRefresher::AddEnum-Methode fügt der angeforderten Aktualisierung einen Enumerator hinzu.

Syntax

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Parameter

[in] pNamespace

Ein IWbemServices-Zeiger zurück in die Windows-Verwaltung, die jede Anforderung des Anbieters verarbeiten kann. Wenn die Methode während der Ausführung die Windows-Verwaltung zurückrufen muss, sollte der Anbieter AddRef mit dem pNamespace-Zeiger aufrufen.

[in] wszClassName

Konstante, NULL-endende Zeichenfolge mit 16-Bit-Unicode-Zeichen, die den Namen der aufgezählten Klasse enthalten.

[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 Instanzen lokalisierte Qualifizierer, sofern sie verfügbar sind.

[in] pContext

In der Regel NULL; Andernfalls ist dies ein Zeiger auf ein IWbemContext-Objekt , das von mindestens einem dynamischen Klassenanbieter erforderlich ist. 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] ppEnum

Zeiger, der den Verweis auf ein IWbemHiPerfEnum-Objekt enthält, das die Enumeration enthält. Der Client muss Release für diesen Zeiger aufrufen, wenn er nicht mehr benötigt wird.

[out] plId

Zeiger auf eine ganze Zahl, die vom Anbieter zurückgegeben wird, die die aktualisierbare Enumeration 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

HinweisHRESULT

Hinweise

Die angegebene Klasse muss eine gültige Klasse angeben, die vom High-Performance Anbieter bereitgestellt wird. Alle Instanzen des zurückgegebenen Enumerators können nach Aufrufen abgefragt werden. Bei jedem Aktualisierungsaufruf kann die Anzahl der Instanzen im Enumerator variieren. Es werden nur Instanzen des angegebenen Klassennamens zurückgegeben. Unterklassen der angegebenen Klasse werden nicht aufgezählt, da die detaillierte Enumeration nicht unterstützt wird. Der zurückgegebene Enumerator 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. Beachten Sie, dass der Benutzer hinzugefügte Enumeratoren nicht explizit entfernen muss. Der Client muss jedoch Release für den zurückgegebenen Enumerator aufrufen, wenn er 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

IWbemConfigureRefresher

Freigeben über