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 |
Library | User32.lib |
DLL | User32.dll |
可再发行组件 | Windows NT 4.0 SP6 及更高版本和 Windows 98 上的 Active Accessibility 2.0 RDK |
API 集 | ext-ms-win-ntuser-server-l1-1-1 (在 Windows 10 版本 10.0.14393 中引入) |