IUIAutomation::RemoveAutomationEventHandler 方法 (uiautomationclient.h)
拿掉指定的 使用者介面自動化 事件處理程式。
語法
HRESULT RemoveAutomationEventHandler(
[in] EVENTID eventId,
[in] IUIAutomationElement *element,
[in] IUIAutomationEventHandler *handler
);
參數
[in] eventId
類型: EVENTID
正在處理之事件的標識碼。 如需事件標識碼的清單,請參閱 事件標識碼。
[in] element
類型: IUIAutomationElement*
正在處理事件的 使用者介面自動化 專案的指標。
[in] handler
類型: IUIAutomationEventHandler*
傳遞給指定事件標識碼和 使用者介面自動化 元素之 IUIAutomation::AddAutomationEventHandler 之處理程式方法的指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
使用者介面自動化 客戶端不應該使用多個線程來新增或移除事件處理程式。 如果在相同客戶端進程中新增或移除另一個事件處理程式時,就會產生非預期的行為。
如果事件與取消訂閱事件的要求同時收到,則事件可以在未訂閱處理程式之後傳遞至事件處理程式。 最佳做法是遵循元件物件模型 (COM) 標準,並避免終結事件處理程序物件,直到其參考計數達到零為止。 取消訂閱事件之後立即終結事件處理程式,可能會導致延遲傳遞事件時發生存取違規。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用於 Windows Vista 的平臺更新 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | uiautomationclient.h (包含 UIAutomation.h) |
另請參閱
RemoveFocusChangedEventHandler