NextMethod-Funktion
Hiermit wird die nächste Methode in einer Enumeration abgerufen, die mit einem Aufruf von BeginMethodEnumeration startet.
Hinweis
Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.
Syntax
HRESULT NextMethod (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] BSTR* pName,
[out] IWbemClassObject** ppInSignature,
[out] IWbemClassObject** ppOutSignature
);
Parameter
vFunc
[in] Dieser Parameter wird nicht verwendet.
ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.
lFlags
[in]: Reserviert Dieser Parameter muss 0 sein.
pName
[out] Ein Zeiger, der auf null von vor dem Aufruf zeigt. Wenn die Funktion zurückgegeben wird, die Adresse einer neuen BSTR, die den Methodennamen enthält.
ppSignatureIn
[out] Ein Zeiger, der einen Zeiger auf ein IWbemClassObject empfängt, das die in-Parameter für die Methode enthält.
ppSignatureOut
[out] Ein Zeiger, der einen Zeiger auf ein IWbemClassObject empfängt, das die out-Parameter für die Methode enthält.
Rückgabewert
Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:
| Konstante | Wert | BESCHREIBUNG |
|---|---|---|
WBEM_E_UNEXPECTED |
0x8004101d | Die BeginEnumeration-Funktion wurde nicht aufgerufen. |
WBEM_S_NO_ERROR |
0 | Der Funktionsaufruf war erfolgreich. |
WBEM_S_NO_MORE_DATA |
0x40005 | In der Enumeration sind keine weiteren Eigenschaften vorhanden. |
Bemerkungen
Diese Funktion umschließt einen Aufruf der IWbemClassObject::NextMethod-Methode.
Der Aufrufer beginnt die Enumerationssequenz durch Aufrufen der BeginMethodEnumeration-Funktion und ruft dann die [NextMethod]-Funktion auf, bis die Funktion WBEM_S_NO_MORE_DATA zurückgibt. Optional beendet der Aufrufer die Sequenz, durch Aufrufen von EndMethodEnumeration. Der Aufrufer kann die Enumeration frühzeitig beenden, indem er jederzeit EndMethodEnumeration aufruft.
Beispiel
Ein C++-Beispiel finden Sie unter der IWbemClassObject::NextMethod-Methode.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: WMINet_Utils.idl
.NET Framework-Versionen: Seit Version 4.7.2 verfügbar
