共用方式為


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
E_POINTER
指標 pvValueNULL
E_INVALIDARG
參數 cbValue 不符合屬性值的必要大小。
E_OUTOFMEMORY
記憶體不足。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IDeviceSpecificProperty 介面