IsWinEventHookInstalled 函式 (winuser.h)
判斷是否有已安裝的 WinEvent 攔截,可能會收到指定事件的通知。
語法
BOOL IsWinEventHookInstalled(
[in] DWORD event
);
參數
[in] event
類型: DWORD
攔截的事件常數可能會收到通知。 函式會檢查此事件常數是否有已安裝的勾點。
傳回值
類型: BOOL
如果收到指定事件通知的勾點,則傳回值為 TRUE。
如果沒有攔截可通知指定的事件,傳回值為 FALSE。
備註
這個方法保證永遠不會傳回誤判。 如果這個方法傳回 FALSE,表示系統不會收到事件的通知。 不過,這個方法可能會傳回誤判。 換句話說,即使沒有收到通知的勾點,它還是可能會傳回 TRUE 。 因此,如果此方法傳回 FALSE,元件可以放心規避某些工作。
事件攔截可以隨時安裝,因此伺服器開發人員不應該快取長時間的傳回值。
規格需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h |
程式庫 | User32.lib |
Dll | User32.dll |
可轉散發套件 | Windows NT 4.0 上的 Active Accessibility 2.0 RDK 與 SP6 和更新版本和 Windows 98 |
API 集合 | ext-ms-win-ntuser-server-l1-1-1 (于 Windows 10 10.0.14393 版) |