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 中引入)

另请参阅

SetWinEventHook

UnhookWinEvent