IWbemClassObject::NextMethod method (wbemcli.h)

Article
10/13/2021

The IWbemClassObject::NextMethod method is used to retrieve the next method in a method enumeration sequence that starts with a call to IWbemClassObject::BeginMethodEnumeration.

This call is only supported if the current object is a CIM class definition. Method manipulation is not available from IWbemClassObject pointers that point to CIM instances.

Syntax

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

Parameters

[in] lFlags

Reserved. This parameter must be 0 (zero).

[out] pstrName

A pointer that should point to NULL prior to the call. This parameter receives the address of a BSTR value containing the method name. The caller must release the string using SysFreeString when it is no longer required.

[out] ppInSignature

A pointer that receives a pointer to an IWbemClassObject containing the in parameters for the method.

[out] ppOutSignature

A pointer that receives a pointer to an IWbemClassObject containing the out parameters for the method.

Return value

This method returns an HRESULT indicating the status of the method call. The following list lists the value contained within an HRESULT. For general HRESULT values, see System Error Codes.

Remarks

The caller begins the enumeration sequence using IWbemClassObject::BeginMethodEnumeration, and then calls IWbemClassObject::NextMethod until WBEM_S_NO_MORE_DATA is returned. The caller, optionally, finishes the sequence with IWbemClassObject::EndMethodEnumeration. The caller may terminate the enumeration early by calling IWbemClassObject::EndMethodEnumeration at any time.

Note The caller must call IWbemClassObject::Release on the ppInSignature and ppOutSignature pointers when these objects are no longer required.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (include Wbemidl.h)
Library	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Share via