GetPropertyQualifierSet 函数

检索特定属性的限定符集。

注意

此 API 仅供内部使用。 不应从开发人员代码中使用。

语法

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

参数

vFunc
[in] 未使用此参数。

ptr
[in] 指向 IWbemClassObject 实例的指针。

wszMethod
[in] 属性名称。 wszProperty 必须指向有效的 LPCWSTR

ppQualSet
[out] 接收允许访问属性限定符的接口指针。 ppQualSet 不能为 null。 如果发生错误,则不会返回新对象,指针将设置为指向 null

返回值

此函数返回的以下值是在 WbemCli.h 头文件中定义的,你也可以在代码中将这些值定义为常数:

常数 Value 说明
WBEM_E_FAILED 0x80041001 发生一般性故障。
WBEM_E_NOT_FOUND 0x80041002 指定的方法不存在。
WBEM_E_OUT_OF_MEMORY 0x80041006 没有足够的可用内存来完成该操作。
WBEM_E_INVALID_PARAMETER 0x80041008 参数为 null
WBEM_E_SYSTEM_PROPERTY 0x80041030 函数尝试获取系统属性的限定符。
WBEM_S_NO_ERROR 0 函数调用成功。

注解

此函数包装对 IWbemClassObject::GetPropertyQualifierSet 方法的调用。

只有在当前对象是 CIM 类定义时,才支持调用此函数。 方法操作不可用于指向 CIM 实例的 IWbemClassObject 指针。

由于每个方法可能都有自己的限定符,因此 IWbemQualifierSet 指针可让调用方添加、编辑或删除这些限定符。

由于系统属性没有限定符,如果你尝试获取系统属性的 IWbemQualifierSet 指针,函数将返回 WBEM_E_SYSTEM_PROPERTY

要求

平台:请参阅系统要求

标头:WMINet_Utils.idl

.NET Framework 版本:自 4.7.2 起可用

另请参阅