IDeviceSpecificProperty::SetValue 方法 (devicetopology.h)
SetValue 方法會設定裝置特定屬性的值。
語法
HRESULT SetValue(
[in] void *pvValue,
[in] DWORD cbValue,
[in] LPCGUID pguidEventContext
);
參數
[in] pvValue
裝置特定屬性之新值的指標。
[in] cbValue
裝置特定屬性值的位元組大小。
[in] pguidEventContext
IControlChangeNotify::OnNotify 方法的內容值。 此參數指向事件內容 GUID。 如果 SetValue 呼叫變更控件的狀態,則所有已註冊 IControlChangeNotify 介面的用戶端都會收到通知。 在 OnNotify 方法的實作中,用戶端可以檢查事件內容 GUID,以探索它或另一個用戶端是否為控件變更事件的來源。 如果呼叫端提供此參數的 NULL 指標,則用戶端的通知方法會收到 NULL 內容指標。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
指標 pvValue 為 NULL。 |
|
參數 cbValue 不符合屬性值的必要大小。 |
|
記憶體不足。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |