共用方式為


unhookWinEvent 函式 (winuser.h)

拿掉先前呼叫 SetWinEventHook 所建立的事件攔截函式。

語法

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

參數

[in] hWinEventHook

類型: HWINEVENTHOOK

在先前呼叫 SetWinEventHook 中傳回的事件攔截句柄。

傳回值

類型: BOOL

如果成功,則傳回 TRUE;否則會傳回 FALSE

三個常見的錯誤會導致此函式失敗:

  • hWinEventHook 參數為 NULL 或無效。
  • hWinEventHook 指定的事件攔截已移除。
  • UnhookWinEvent 是從與 SetWinEventHook 原始呼叫不同的線程呼叫。

備註

此函式會移除 hWinEventHook 所指定的事件勾點,以防止對應的回呼函式接收進一步的事件通知。 如果客戶端的線程結束,系統會自動呼叫此函式。

從安裝事件攔截的相同線程呼叫此函式。 如果從與對應至 SetWinEventHook 之呼叫不同的線程呼叫,則 UnhookWinEvent 會失敗。

如果安裝此事件攔截時指定了WINEVENT_INCONTEXT,系統會嘗試從載入它的所有進程卸除對應的 DLL。 雖然卸除不會立即發生,但在 UnhookWinEvent 傳回之後,不會呼叫攔截函式。 如需WINEVENT_INCONTEXT的詳細資訊,請參閱 內容內攔截函式

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll
可轉散發套件 Windows NT 4.0 上的 Active Accessibility 1.3 RDK 與 SP6 和更新版本和 Windows 95