Collects log data in the same format as the Windows ReportEvent function, and passes it to the Windows machine for logging. A null UserID security ID is given.

BOOLEAN ReportRtEvent(
    PVOID hEventLog      
    WORD wType,          
    WORD wCategory,      
    DWORD dwEventID,     
    WORD wNumStrings,    
    DWORD dwDataSize,    
    LPSTR *lpStrings,    
    LPVOID lpRawData     
);

Parameters

hEventLog

Identifies the event log. This parameter should be set to NULL.

wType

Specifies the type of event being logged. This parameter can be one of the following values:

Value	Meaning
EVENTLOG_ERROR_TYPE	Error event.
EVENTLOG_WARNING_TYPE	Warning event.
EVENTLOG_INFORMATION_TYPE	Information event.

For more information about event types, see Event Logging in the Win32 SDK.

wCategory

Specifies the event category. This is source-specific information; the category can have any value.

dwEventID

Specifies the event identifier. The event identifier specifies the message that goes with this as an entry in the EventMsg.dll message file. See the EventMsg.h file for valid event ids.

wNumStrings

Specifies the number of strings in the array pointed to by lpStrings. A value of 0 (zero) indicates that no strings exist.

dwDataSize

Specifies the number of bytes of event-specific raw (binary) data to write to the log. If this parameter is 0 (zero), no event-specific data is present.

lpStrings

Points to a buffer that contains an array of null-terminated strings merged into the message before Event Viewer displays the string. This parameter must be a valid pointer (or NULL), even if wNumStrings is zero.

lpRawData

Points to the buffer that contains binary data. This parameter must be a valid pointer (or NULL), even if dwDataSize is zero.

Return Values

TRUE

Success. Indicates that the entry was written to the log.

FALSE

Failure. To determine the status, call GetLastRtError.

Requirements