描述
WritePropertyValue方法将指定数量的字节写入由属性句柄标识的属性。使用此方法设置字符串和所有其他非DWORD或非QWORD数据。
C++ 语法
HRESULT WritePropertyValue( [in] long lHandle, [in] long lNumBytes, [in] const byte *aData ); |
PowerBASIC 语法
METHOD WriteQWORD ( _ BYVAL lHandle AS LONG, _ BYVAL lNumBytes AS LONG, _ BYVAL aData AS BYTE PTR _ ) AS LONG |
参数
lHandle
包含标识此属性的句柄的整数。
lNumBytes
包含要写入属性的字节数的整数。对于非字符属性值，lNumBytes必须是指定的属性类型的正确数据大小。对于字符串属性值（如引用，字符串和日期时间），lNumBytes必须是以字节为单位的指定字符串的长度，并且字符串本身的字节长度必须为偶数，并且后跟一个空终止字符。
aData
指向包含数据的常量字节类型数组。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_S_NO_ERROR |
该方法成功。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_TYPE_MISMATCH |
发生类型不匹配。 |
要求
客户 |
需要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。 |