GetPropertyQualifierSet function

Artikkeli
09/15/2021

Retrieves the qualifier set for a particular property.

Note

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

Syntax

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parameters

vFunc
[in] This parameter is unused.

ptr
[in] A pointer to an IWbemClassObject instance.

wszMethod
[in] The property name. wszProperty must point to a valid LPCWSTR.

ppQualSet
[out] Receives the interface pointer that allows access to the qualifiers of the property. ppQualSet cannot be null. If an error occurs, a new object is not returned, and the pointer is set to point to 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_FAILED`	0x80041001	There has been a general failure.
`WBEM_E_NOT_FOUND`	0x80041002	The specified method does not exist.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Not enough memory is available to complete the operation.
`WBEM_E_INVALID_PARAMETER`	0x80041008	A parameter is `null`.
`WBEM_E_SYSTEM_PROPERTY`	0x80041030	The function attempts to get qualifiers of a system property.
`WBEM_S_NO_ERROR`	0	The function call was successful.

Remarks

This function wraps a call to the IWbemClassObject::GetPropertyQualifierSet method.

A call to this function is supported only if the current object is a CIM class definition. Method manipulation is not available for IWbemClassObject pointers that point to CIM instances.

Because each method may have its own qualifiers, the IWbemQualifierSet pointer lets the caller add, edit, or delete these qualifiers.

Because system properties have no qualifiers, the function returns WBEM_E_SYSTEM_PROPERTY if you attempt to obtain a IWbemQualifierSet pointer for a system property.

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

Jaa