Функция NotifyChangeEventLog (winbase.h)

Статья
08/27/2023

Позволяет приложению получать уведомления при записи события в указанный журнал событий. Когда событие записывается в журнал, для указанного объекта события устанавливается состояние сигнала.

Синтаксис

BOOL NotifyChangeEventLog(
  [in] HANDLE hEventLog,
  [in] HANDLE hEvent
);

Параметры

[in] hEventLog

Дескриптор журнала событий. Функция OpenEventLog возвращает этот дескриптор.

[in] hEvent

Дескриптор объекта события сброса вручную или автоматического сброса. Используйте функцию CreateEvent для создания объекта события.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Функция NotifyChangeEventLog не работает с удаленными дескрипторами. Если параметр hEventLog является дескриптором для журнала событий на удаленном компьютере, NotifyChangeEventLog возвращает ноль, а GetLastError возвращает ERROR_INVALID_HANDLE.

Если поток не ожидает события, когда система вызывает PulseEvent, поток не получит уведомление. Поэтому следует создать отдельный поток для ожидания уведомлений.

Система будет продолжать уведомлять вас об изменениях, пока вы не закроете дескриптор в журнале событий. Чтобы закрыть журнал событий, используйте функцию CloseEventLog или DeregisterEventSource .

Примеры

Пример см. в разделе Получение уведомления о событии.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll
Набор API	ext-ms-win-advapi32-eventlog-l1-1-1 (представлен в Windows 10 версии 10.0.10240)