QualifierSet_Next-Funktion

  • Artikel

Ruft den nächsten Qualifizierer in einer Enumeration ab, die durch einen Aufruf der QualifierSet_BeginEnumeration-Funktion gestartet wurde.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parameter

vFunc [in] Dieser Parameter wird nicht verwendet.

ptr [in] Ein Zeiger auf eine IWbemQualifierSet-Instanz.

lFlags [in] Reserviert Dieser Parameter muss 0 sein.

pstrName [out] Der Name des Qualifizierers. Falls null, wird dieser Parameter ignoriert. Andernfalls darf pstrName nicht auf einen gültigen BSTR zeigen, oder es tritt Arbeitsspeicherverlust auf. Falls nicht NULL, ordnet die Funktion immer eine neue BSTR zu, wenn sie WBEM_S_NO_ERROR zurückgibt.

pVal [out] Bei erfolgreicher Ausführung der Wert des Qualifizierers. Wenn die Funktion fehlschlägt, wird VARIANT, auf das pVal zeigt, nicht verändert. Wenn dieser Parameter null ist, wird er ignoriert.

plFlavor [out] Ein Zeiger auf einen LONG-Wert, der den Qualifizierertyp empfängt. Wenn keine Typinformationen gewünscht sind, kann dieser Parameter null sein.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der Headerdatei WbemCli.h definiert oder können als Konstanten im Code definiert werden:

Konstante Wert BESCHREIBUNG
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist nicht gültig.
WBEM_E_UNEXPECTED 0x8004101d Der Aufrufer hat QualifierSet_BeginEnumeration nicht aufgerufen.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um eine neue Enumeration zu starten.
WBEM_S_NO_MORE_DATA 0x40005 In der Enumeration sind keine Qualifizierer mehr vorhanden.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemQualifierSet::Next-Methode.

Sie rufen die QualifierSet_Next Funktion wiederholt auf, um alle Qualifizierer aufzuzählen, bis die Funktion WBEM_S_NO_MORE_DATA zurückgibt. Um die Enumeration frühzeitig zu beenden, rufen Sie die QualifierSet_EndEnumeration-Funktion auf.

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: seit Version 4.7.2 verfügbar

Siehe auch