DWbemContext.Next

[This is preliminary documentation and subject to change.]

The DWbemContext.Next method retrieves the next qualifier in an enumeration that was started with DWbemContext.BeginEnumeration

Next(
  [in] lFlags As Long,
  [out] pName As String,
  [out] pVal As VARIANT  
) As Long
 

Parameters

lFlags
Reserved. It must be zero.
pName
String that contains the name of the qualifier returned.I need more information on this parameterIf WBEM_S_NO_MORE_DATA is returned, pName is set to vbNullString.
pVal
This parameter cannot be NULL, and must be of type VARIANT. If no error is returned, the VARIANT is initialized and set to contain the context value. If an error code is returned, the VARIANT in pValue is left unmodified.

If WBEM_S_NO_MORE_DATA is returned, this parameter is set to a VARIANT of type VBNULL.

It is possible that an entire DWbemClassObject is returned inside the VARIANT. If that is the case, CIM_OBJECT is the VARIANT type.

Note  At the end of the enumeration, WBEM_S_NO_MORE_DATA is returned. The returned VARIANT is of type VBNULL, and the returned pName is set to vbNullString.

Return Values

WBEM_E_INVALID_PARAMETER An invalid parameter was specified, or the namespace could not be parsed.
WBEM_E_UNEXPECTED Caller did not call DWbemContext.BeginEnumeration.
WBEM_NO_ERROR Success.
WBEM_S_NO_MORE_DATA No more properties are left in the enumeration.
WBEM_E_OUT_OF_MEMORY There was not enough memory to complete the call.

See Also

DWbemContext.BeginEnumeration, DWbemContext.EndEnumeration