Edit

IWbemClassObject::NextMethod method (wbemcli.h)

  • Article

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