QualifierSet_Next function

Article
09/15/2021

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

Share via