IWbemQualifierSet::Get

[This is preliminary documentation and subject to change.]

The IWbemQualifierSet::Get method gets the specified named qualifier, if found.

HRESULT IWbemQualifierSet::Get(
  [in] BSTR bstrName,
  [in] LONG lFlags,
  [out, OPTIONAL] VARIANT *pVal,
  [out, OPTIONAL] LONG *plFlavor
);

Parameters

bstrName
The qualifier name for which the value is being requested. This must point to a valid BSTR. The pointer is treated as read-only.
lFlags
Reserved. It must be zero.
pVal
When successful, the VARIANT is assigned to the correct type and value for the qualifier. VariantInit is called on this VARIANT.

It is the responsibility of the caller to call VariantClear on the pointer when the value is no longer required. If there is an error code, the VARIANT pointed to by pVal is not modified.

If this parameter is NULL, the parameter is ignored.

plFlavor
Can be NULL. If not NULL, this must point to a LONG that receives the qualifier flavor bits for the requested qualifier. See Qualifier Flavors.

Return Values

WBEM_E_INVALID_PARAMETER One or more parameters were not found, were invalid, or the namespace could not be parsed.
WBEM_E_NOT_FOUND The specified qualifier did not exist.
WBEM_NO_ERROR Success.

See Also

Qualifier Flavors