IUIAutomation：：RemoveAutomationEventHandler 方法 (uiautomationclient.h)

發行項
03/13/2024

拿掉指定的使用者介面自動化事件處理程式。

語法

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)