IWbemQualifierSet::Next-Methode (wbemcli.h)

  • Artikel

Die IWbemQualifierSet::Next-Methode ruft den nächsten Qualifizierer in einer Enumeration ab, die mit IWbemQualifierSet::BeginEnumeration gestartet wurde. Diese Methode wird wiederholt aufgerufen, um alle Qualifizierer aufzulisten, bis WBEM_S_NO_MORE_DATA zurückgibt. Um die Enumeration frühzeitig zu beenden, rufen Sie IWbemQualifierSet::EndEnumeration auf.

Die Reihenfolge der während der Enumeration zurückgegebenen Qualifizierer ist nicht definiert.

Syntax

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pVal,
  [out] long    *plFlavor
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 (null) sein.

[out] pstrName

Dieser Parameter empfängt den Namen des Qualifizierers. Ein neuer BSTR wird immer dann zugewiesen, wenn WBEM_S_NO_ERROR zurückgibt.

Wenn pstrNameNULL ist, wird es ignoriert. Andernfalls muss der Aufrufer sicherstellen, dass dieser Parameter beim Eintrag nicht auf einen gültigen BSTR verweist, andernfalls kommt es zu einem Speicherverlust. Außerdem muss der Aufrufer daran denken, SysFreeString für die zurückgegebene Zeichenfolge aufzurufen, wenn sie nicht mehr erforderlich ist.

[out] pVal

Dieser Parameter empfängt den Wert für den Qualifizierer. VariantInit wird für die VARIANT-Methode aufgerufen. Der Aufrufer muss VariantClear für diesen Zeiger aufrufen, wenn der Wert nicht mehr erforderlich ist. Wenn ein Fehlercode zurückgegeben wird, bleibt der VARIANT-Wert , auf den pVal verweist, unverändert. Dieser Parameter wird ignoriert, wenn er auf NULL festgelegt ist.

[out] plFlavor

Wenn nicht NULL, wird der Wert, auf den verwiesen wird, auf die Qualifizierervariante festgelegt. Weitere Informationen finden Sie unter Qualifier Flavors and WBEM_FLAVOR_TYPE.

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.

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
DLL Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Weitere Informationen

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Qualifizierervarianten