Edit

QualifierSet_Next function

  • Article

Retrieves the next qualifier in an enumeration that started with a call to the QualifierSet_BeginEnumeration function.

Note

This API is for internal use only. It's not intended for use from developer code.

Syntax

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parameters

vFunc [in] This parameter is unused.

ptr [in] A pointer to an IWbemQualifierSet instance.

lFlags [in] Reserved. This parameter must be 0.

pstrName [out] The name of the qualifier. If null, this parameter is ignored; otherwise, pstrName should not point to a valid BSTR or a memory leak occurs. If not null, the function always allocates a new BSTR when it returns WBEM_S_NO_ERROR.

pVal [out] When successful, the value for the qualifier. If the function fails, the VARIANT pointed to by pVal is not modified. If this parameter is null, the parameter is ignored.

plFlavor [out] A pointer to a LONG that receives the qualifier flavor. If flavor information is not desired, this parameter can be null.

Return value

The following values returned by this function are defined in the WbemCli.h header file, or you can define them as constants in your code:

Constant Value Description
WBEM_E_INVALID_PARAMETER 0x80041008 A parameter is not valid.
WBEM_E_UNEXPECTED 0x8004101d The caller did not call QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Not enough memory is available to begin a new enumeration.
WBEM_S_NO_MORE_DATA 0x40005 No more qualifiers are left in the enumeration.
WBEM_S_NO_ERROR 0 The function call was successful.

Remarks

This function wraps a call to the IWbemQualifierSet::Next method.

You call the QualifierSet_Next function repeatedly to enumerate all the qualifiers until the function return WBEM_S_NO_MORE_DATA. To terminate the enumeration early, call the QualifierSet_EndEnumeration function.

The order of the qualifiers returned during the enumeration is undefined.

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

See also