NextMethod-Funktion

  • Artikel

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

Weitere Informationen