Функция IsWinEventHookInstalled (winuser.h)
Определяет, есть ли установленный перехватчик WinEvent, который может получать уведомления об указанном событии.
Синтаксис
BOOL IsWinEventHookInstalled(
[in] DWORD event
);
Параметры
[in] event
Тип: DWORD
Константу события, о которую могут получать уведомления перехватчики. Функция проверяет наличие установленного перехватчика для этой константы события.
Возвращаемое значение
Тип: BOOL
Если имеется перехватчик для уведомления об указанном событии, возвращается значение TRUE.
Если обработчики для уведомления об указанном событии отсутствуют, возвращается значение FALSE.
Комментарии
Этот метод гарантированно никогда не возвращает ложноотрицательный результат. Если этот метод возвращает значение FALSE, это означает, что обработчики в системе не будут получать уведомления о событии. Однако этот метод может возвращать ложноположительный результат. Иными словами, он может возвращать значение TRUE , даже если нет перехватчиков, которые будут получать уведомления. Таким образом, для компонентов безопасно обойти некоторые трудоемкие работы, если этот метод возвращает значение FALSE.
Перехватчики событий можно установить в любое время, поэтому разработчикам серверов не следует кэшировать возвращаемое значение в течение длительного времени.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Распространяемые компоненты | Активные специальные возможности 2.0 RDK в Windows NT 4.0 с пакетом обновления 6 (SP6) и более поздних версий и Windows 98 |
| Набор API | ext-ms-win-ntuser-server-l1-1-1 (представлен в Windows 10 версии 10.0.14393) |