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 起可用