The ReportEvent function writes an entry at the end of the specified event log.
BOOL ReportEvent(
HANDLE hEventLog, // handle returned by RegisterEventSource
WORD wType, // event type to log
WORD wCategory, // event category
DWORD dwEventID, // event identifier
PSID lpUserSid, // user security identifier (optional)
WORD wNumStrings, // number of strings to merge with message
DWORD dwDataSize, // size of binary data, in bytes
LPCTSTR *lpStrings, // array of strings to merge with message
LPVOID lpRawData // address of binary data
);
Value | Meaning |
---|---|
EVENTLOG_ERROR_TYPE | Error event |
EVENTLOG_WARNING_TYPE | Warning event |
EVENTLOG_INFORMATION_TYPE | Information event |
EVENTLOG_AUDIT_SUCCESS | Success Audit event |
EVENTLOG_AUDIT_FAILURE | Failure Audit event |
For more information about event types, see Event Types.
If the function succeeds, the return value is nonzero, indicating that the entry was written to the log.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
This function is used to log an event. The entry is written to the end of the configured logfile for the source identified by the hEventLog parameter. The ReportEvent function adds the time, the entry's length, and the offsets before storing the entry in the log. To enable the function to add the username, you must supply the user's SID in the lpUserSid parameter.
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Event Logging Overview, Event Logging Functions, ClearEventLog, CloseEventLog, OpenEventLog, ReadEventLog, RegisterEventSource