GetMethodQualifierSet function

Artikkeli
09/15/2021

Retrieves the qualifier set for a particular method.

Note

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

Syntax

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

Parameters

vFunc
[in] This parameter is unused.

ptr
[in] A pointer to an IWbemClassObject instance.

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

ppQualSet
[out] Receives the interface pointer that allows access to the qualifiers of the method. 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_NOT_FOUND`	0x80041002	The specified method does not exist.
`WBEM_E_INVALID_PARAMETER`	0x80041008	A parameter is `null`.
`WBEM_S_NO_ERROR`	0	The function call was successful.

Remarks

This function wraps a call to the IWbemClassObject::GetMethodQualifierSet 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.

Requirements

Platforms: See System Requirements.

Header: WMINet_Utils.idl

.NET Framework Versions: Available since 4.7.2

Jaa