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 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 參數無效。 |
WBEM_E_TYPE_MISMATCH |
0x80041005 | 發生型別不符。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝向 IWbemClassObject::WritePropertyValue 方法發出的呼叫。
使用此函式來設定字串和其他所有非 DWORD 或非 QWORD 資料。
如果是非字串屬性值，lNumBytes 必須是指定屬性型別的正確資料大小。 如果是字串屬性值，lNumBytes 必須是指定字串長度 (以位元組為單位)，而且字串本身必須是偶數的長度 (以位元組為單位)，後面接著 Null 終止字元。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
