NotifyChangeEventLog

Overview

Group

Quick Info

Windows NT
Yes
Win95
No
Win32s
Yes
Import Library
advapi32.lib
Header File
winbase.h
Unicode
No
Platform Notes
None

The NotifyChangeEventLog function lets an application receive notification when an event is written to the event log file specified by the hEventLog parameter. When the event is written to the event log file, the function causes the event object specified by the hEvent parameter to become signaled.

BOOL NotifyChangeEventLog(

HANDLE hEventLog,	// handle to an event log
HANDLE hEvent	// handle to a Win32 event
);

Parameters
hEventLog

Handle to an event log file, obtained by calling OpenEventLog function. When an event is written to this log file, the event specified by hEvent becomes signaled.

hEvent

A handle to a Win32 event. This is the event that becomes signaled when an event is written to the event log file specified by the hEventLog parameter.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks
The NotifyChangeEventLog function does not work with remote handles. If hEventLog is the handle of an event log on a remote computer, the NotifiyChangeEventLog function returns FALSE, and GetLastError returns ERROR_INVALID_HANDLE.