描述
ReadPropertyValue方法返回与属性句柄相关联的属性的指定数量的字节。使用此方法读取包含字符串的属性的值或读取包含非32（DWORD）或64（QWORD）位的值的属性。
C++ 语法
HRESULT ReadPropertyValue( [in] long lHandle, [in] long lBufferSize, [out] long *plNumBytes, [out] byte *aData ); |
PowerBASIC 语法
METHOD ReadPropertyValue ( _ BYVAL lHandle AS LONG, _ BYVAL lBufferSize AS LONG, _ BYREF plNumBytes AS LONG, _ BYVAL aData AS BYTE PTR _ ) AS LONG |
参数
lHandle
包含识别此属性的句柄的整数。
lBufferSize
包含缓冲区大小的整数。
plNumBytes
指向一个整数用于返回读取的字节数。
aData
指向用于返回属性数据的数组的指针。
返回值
该方法返回一个HRESULT，表示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_BUFFER_TOO_SMALL |
提供的缓冲区太小，无法读取字符串属性。 |
WBEM_S_FALSE |
该属性为NULL。 |
WBEM_S_NO_ERROR |
该方法成功。 |
备注
字符串数据返回为空终止WCHAR数据。
要求
客户 |
需要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。 |