WritePropertyValue 函数
将指定数量的字节写入由属性句柄标识的属性。
注意
此 API 仅供内部使用。 不应从开发人员代码中使用。
语法
HRESULT WritePropertyValue (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] long lHandle,
[in] long lNumBytes,
[in] byte* aData
);
参数
vFunc
[in] 未使用此参数。
ptr
[in] 指向 IWbemObjectAccess 实例的指针。
lHandle
[in] 一个整数，其中包含标识此属性的句柄。 可以通过调用 GetPropertyHandle 函数来检索句柄。
lNumBytes
[in] 写入属性的字节数。 有关详细信息，请参阅备注部分。
pHandle [out] 指向包含数据的字节数组的指针。
返回值
此函数返回的以下值是在 WbemCli.h 头文件中定义的，你也可以在代码中将这些值定义为常数：
| 常数 | Value | 说明 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 参数无效。 |
WBEM_E_TYPE_MISMATCH |
0x80041005 | 出现类型不匹配。 |
WBEM_S_NO_ERROR |
0 | 函数调用成功。 |
注解
使用此函数设置字符串和所有其他非 DWORD 或非 QWORD 数据。
对于非字符串属性值，lNumBytes 必须是指定的属性类型的正确数据大小。 对于字符串属性值，lNumBytes 必须是指定字符串的长度（以字节为单位），字符串本身必须为偶数长度（以字节为单位），且后跟 null 终止字符。
要求
平台：请参阅系统要求。
标头：WMINet_Utils.idl
.NET Framework 版本：自 4.7.2 起可用
