DIWbemQualifierSet.Next

[This is preliminary documentation and subject to change.]

The DIWbemQualifierSet.Next method retrieves the next qualifier in an enumeration that started with DIWbemQualifierSet.BeginEnumeration. Call this method repeatedly to enumerate all the qualifiers until WBEM_S_NO_MORE_DATA returns. If you need to terminate the enumeration early, you should call DIWbemQualifierSet.EndEnumeration.

The order of the qualifiers returned during the enumeration is not defined.

DIWbemQualifierSet.Next(
  [in] lFlags As Long,
  [out, OPTIONAL] pName As String,
  [out, OPTIONAL] pVal As VARIANT,
  [out, OPTIONAL] plFlavor As Long 
) As Long
 

Parameters

lFlags
Reserved. It must be zero.
pName
String containing next qualifier.
pVal
This parameter receives the value for the qualifier. If an error code is returned, the VARIANT in pVal is left unmodified.
plFlavor
If not NULL, the value is set to the qualifier flavor. See Qualifier Flavors.

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 DIWbemQualifierSet.BeginEnumeration.
WBEM_NO_ERROR Success.
WBEM_S_NO_MORE_DATA No more properties are left in the enumeration.

See Also

DIWbemQualifierSet.BeginEnumeration, DIWbemQualifierSet.EndEnumeration, Qualifier Flavors