ReportEvent函数在指定事件日志的末尾写入一个条目。
BOOL ReportEvent(
| HANDLE 【hEventLog】, | //由RegisterEventSource返回的句柄 |
| WORD 【WTYPE】, | //要记录的事件类型 |
| WORD 【wCategory】, | //事件类别 |
| DWORD 【dwEventID】, | //事件标识符 |
| PSID 【lpUserSid】, | //用户安全标识符（可选） |
| WORD 【wNumStrings】, | //要与消息合并的字符串数 |
| DWORD 【dwDataSize】, | //二进制数据的大小，以字节为单位 |
| LPCTSTR *【lpStrings】, | //要与消息合并的字符串数组 |
| LPVOID 【lpRawData】 | //二进制数据的地址 |
| ); |
参数
【hEventLog】
标识事件日志。该句柄由RegisterEventSource函数返回。
【WTYPE】
指定正在记录的事件的类型。此参数可以是以下值之一：
| 值 | 含义 |
| EVENTLOG_ERROR_TYPE | 错误事件 |
| EVENTLOG_WARNING_TYPE | 警告事件 |
| EVENTLOG_INFORMATION_TYPE | 信息事件 |
| EVENTLOG_AUDIT_SUCCESS | 成功审核活动 |
| EVENTLOG_AUDIT_FAILURE | 失败审核事件 |
有关事件类型的更多信息，请参阅事件记录.
【wCategory】
指定事件类别。这是源特定信息;该类别可以有任何价值。
【dwEventID】
指定事件标识符。事件标识符将与该事件一起发送的消息指定为与事件源关联的消息文件中的条目。
【lpUserSid】
指向当前用户的安全标识符。如果不需要安全标识符，此参数可以为NULL。
【wNumStrings】
指定由【lpStrings】参数指向的数组中的字符串数。值为零表示不存在任何字符串。
【dwDataSize】
指定要写入日志的事件特定原始（二进制）数据的字节数。如果此参数为零，则不存在任何特定于事件的数据。
【lpStrings】
指向缓冲区，该缓冲区包含一个以null结尾的字符串数组，并将其合并到消息中，然后事件查看器将该字符串显示给用户。该参数必须是有效的指针（或NULL），即使【wNumStrings】为零。
【lpRawData】
指向包含二进制数据的缓冲区。该参数必须是有效的指针（或NULL），即使【dwDataSize】参数为零。
返回值
如果函数成功，则返回值不为零，表示该条目已写入日志。
如果函数失败，返回值为零。要获取扩展错误信息，请调用GetLastError.
备注
此函数用于记录事件。该条目写入由【hEventLog】参数标识的源的配置的日志文件的末尾。在日志中存储条目之前，ReportEvent功能添加时间，用户名，条目长度和偏移量。
也可以看看
ClearEventLog, CloseEventLog, OpenEventLog, ReadEventLog, RegisterEventSource
