QualifierSet_Next-Funktion
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
