IWbemClassObject::NextMethod-Methode (wbemcli.h)

Artikel
03/03/2024

Die IWbemClassObject::NextMethod-Methode wird verwendet, um die nächste Methode in einer Methodenaufzählungssequenz abzurufen, die mit einem Aufruf von IWbemClassObject::BeginMethodEnumeration beginnt.

Dieser Aufruf wird nur unterstützt, wenn das aktuelle Objekt eine CIM-Klassendefinition ist. Die Methodenbearbeitung ist über IWbemClassObject-Zeiger, die auf CIM-Instanzen verweisen, nicht möglich.

Syntax

HRESULT NextMethod(
  [in]  long             lFlags,
  [out] BSTR             *pstrName,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 (null) sein.

[out] pstrName

Ein Zeiger, der vor dem Aufruf auf NULL zeigen soll. Dieser Parameter empfängt die Adresse eines BSTR-Werts , der den Methodennamen enthält. Der Aufrufer muss die Zeichenfolge mithilfe von SysFreeString freigeben, wenn sie nicht mehr erforderlich ist.

[out] ppInSignature

Ein Zeiger, der einen Zeiger auf ein IWbemClassObject empfängt, das die in-Parameter für die -Methode enthält.

[out] ppOutSignature

Ein Zeiger, der einen Zeiger auf ein IWbemClassObject empfängt, das die out-Parameter für die -Methode enthält.

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. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

Der Aufrufer beginnt die Enumerationssequenz mit IWbemClassObject::BeginMethodEnumeration und ruft dann IWbemClassObject::NextMethod auf, bis WBEM_S_NO_MORE_DATA zurückgegeben wird. Optional beendet der Aufrufer die Sequenz mit IWbemClassObject::EndMethodEnumeration. Der Aufrufer kann die Enumeration frühzeitig beenden, indem er jederzeit IWbemClassObject::EndMethodEnumeration aufruft .

Hinweis Der Aufrufer muss IWbemClassObject::Release für die Zeiger ppInSignature und ppOutSignature aufrufen, wenn diese Objekte nicht mehr erforderlich sind.

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	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Freigeben über