描述
GetPropertyHandle方法返回一个唯一的句柄，用于标识属性。使用IWbemObjectAccess方法读取或写入属性值时，可以使用此句柄来标识属性。
C++ 语法
HRESULT GetPropertyHandle( [in] LPCWSTR wszPropertyName, [out] CIMTYPE *pType, [out] long *plHandle ); |
PowerBASIC 语法
METHOD GetPropertyHandle ( _ BYREF wszPropertyName AS WSTRINGZ, _ BYREF pType AS LONG, _ BYREF plHandle AS LONG _ ) AS LONG |
参数
wszPropertyName
包含属性名称的16位Unicode字符的常量，以null结尾的字符串。
pType
指向CIMTYPE的指针用于返回属性的CIM类型。
plHandle
指向用于返回属性句柄的整数的指针。
返回值
此方法返回一个HRESULT，表示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_S_NO_ERROR |
通话成功。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_NOT_FOUND |
指定的属性名称不存在。 |
WBEM_E_NOT_SUPPORTED |
请求属性的类型为CIM_OBJECT或CIM_ARRAY。 |
备注
可以检索除CIM_OBJECT和CIM_ARRAY之外的所有数据类型的句柄。返回的句柄可以处理所有类的实例。
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional，Windows NT Workstation 4.0 SP4及更高版本，Windows Me，Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
DLL |
需要Esscli.dll。 需要Fastprox.dll。 需要Wbemess.dll。 |