QualifierSet_Get function

Artikkeli
09/15/2021

Gets the specified named qualifier.

Note

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

Syntax

HRESULT QualifierSet_Get (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] LONG                 lFlags,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parameters

vFunc [in] This parameter is unused.

ptr [in] A pointer to an IWbemQualifierSet instance.

wszName [in] The name of the qualifier whose value is requested.

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

pVal [out] When successful, the correct type and 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 bits for the requested qualifier. 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_NOT_FOUND`	0x80041002	The specified qualifier does not exist.
`WBEM_S_NO_ERROR`	0	The function call was successful.

Remarks

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

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

Jaa