Skip to content

Latest commit

 

History

History
86 lines (66 loc) · 3.06 KB

nf-winuser-iswineventhookinstalled.md

File metadata and controls

86 lines (66 loc) · 3.06 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name req.apiset
NF:winuser.IsWinEventHookInstalled
IsWinEventHookInstalled function (winuser.h)
Determines whether there is an installed WinEvent hook that might be notified of a specified event.
IsWinEventHookInstalled
IsWinEventHookInstalled function [Windows Accessibility]
_msaa_IsWinEventHookInstalled
msaa.iswineventhookinstalled
winauto.iswineventhookinstalled
winuser/IsWinEventHookInstalled
winauto\iswineventhookinstalled.htm
WinAuto
bc1e97ad-748d-420a-8c9a-72a555b685e1
12/05/2018
IsWinEventHookInstalled, IsWinEventHookInstalled function [Windows Accessibility], _msaa_IsWinEventHookInstalled, msaa.iswineventhookinstalled, winauto.iswineventhookinstalled, winuser/IsWinEventHookInstalled
winuser.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
User32.lib
User32.dll
Windows
Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98
19H1
IsWinEventHookInstalled
winuser/IsWinEventHookInstalled
c++
APIRef
kbSyntax
DllExport
User32.dll
API-MS-Win-RTCore-NTUser-Winevent-l1-1-0.dll
minuser.dll
IsWinEventHookInstalled
ext-ms-win-ntuser-server-l1-1-1 (introduced in Windows 10, version 10.0.14393)

IsWinEventHookInstalled function

-description

Determines whether there is an installed WinEvent hook that might be notified of a specified event.

-parameters

-param event [in]

Type: DWORD

The event constant that hooks might be notified of. The function checks whether there is an installed hook for this event constant.

-returns

Type: BOOL

If there is a hook to be notified of the specified event, the return value is TRUE.

If there are no hooks to be notified of the specified event, the return value is FALSE.

-remarks

This method is guaranteed to never return a false negative. If this method returns FALSE, it means that no hooks in the system would be notified of the event. However, this method may return a false positive. In other words, it may return TRUE even though there are no hooks that would be notified. Thus, it is safe for components to circumvent some work if this method returns FALSE.

Event hooks can be installed at any time, so server developers should not cache the return value for long periods of time.

-see-also

SetWinEventHook

UnhookWinEvent