Поделиться через


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

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

Синтаксис

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)

См. также раздел

CloseEventLog

CreateEvent

Отмена регистрацииEventSource

Функции ведения журнала событий

OpenEventLog