IControlChangeNotify::OnNotify 方法 (devicetopology.h)
OnNotify 方法會在連接器或子單位的狀態變更時通知用戶端。
語法
HRESULT OnNotify(
[in] DWORD dwSenderProcessId,
[in] LPCGUID pguidEventContext
);
參數
[in] dwSenderProcessId
變更控制項狀態之客戶端的進程識別碼。 如果硬體事件產生通知,此進程標識碼會與客戶端的進程標識碼不同。 如需詳細資訊,請參閱<備註>。
[in] pguidEventContext
控件變更事件之內容 GUID 的指標。 起始控件變更的用戶端會提供此 GUID。 如需詳細資訊,請參閱<備註>。
傳回值
如果方法成功,它會傳回 S_OK。 如果方法失敗,則會傳回錯誤碼。
備註
用戶端可以使用這個方法來追蹤其他進程和硬體所做的控制變更。 不過,變更控件設定的用戶端通常會忽略控件變更所產生的通知。 在其 OnNotify 方法的實作中,用戶端可以檢查 dwSenderProcessId 和 pguidEventContext 參數,以探索它或另一個用戶端是否為控件變更事件的來源。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |