Platform SDK: Debugging and Error Handling |
The ReportEvent function writes an entry at the end of the specified event log.
BOOL ReportEvent( HANDLE hEventLog, // handle to event log WORD wType, // event type WORD wCategory, // event category DWORD dwEventID, // event identifier PSID lpUserSid, // user security identifier WORD wNumStrings, // number of strings to merge DWORD dwDataSize, // size of binary data LPCTSTR *lpStrings, // array of strings to merge LPVOID lpRawData // binary data buffer );
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/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
Event Logging Overview, Event Logging Functions, ClearEventLog, CloseEventLog, OpenEventLog, ReadEventLog, RegisterEventSource