GetPropertyHandle 函数
返回标识属性的唯一句柄。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemObjectAccess 实例的指针。
wszPropertyName
[in] 以 NULL 结尾的 UTF16 编码字符的字符串，其中包含属性名称。
pType
[out] 一个指针，指向表示属性的 CIM 类型的 CIMTYPE 枚举成员。
pHandle
[out] 指向包含属性句柄的整数的指针。
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_NOT_FOUND |
0x80041002 | 未找到指定的属性名称。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_NOT_SUPPORTED |
0x8004100c | 请求的属性属于 CIM_OBJECT 或 CIM_ARRAY 类型。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
此函数包装对 IWbemClassObject::GetPropertyHandle 方法的调用。
使用 IWbemObjectAccess 方法读取或写入属性值时，可以使用此句柄来确定属性。
对于除 CIM_OBJECT 和 CIM_ARRAY 之外的所有数据类型的属性，可以检索句柄。 返回的句柄在类的所有实例中运行。
要求
平台：请参阅系统要求。
标头：WMINet_Utils.idl
.NET Framework 版本：自 4.7.2 起可用
