【WCE】使用事件日志服务(三)

*《【WCE】使用事件日志服务(三 / 四)》的内容已重新调整过。

Windows CE 的 Event Logging API 有如下 10 个函数：

BOOL WINAPI ReportEventW(HANDLE hEventLog, WORD wType, WORD wCategory, DWORD dwEventID, PSID lpUserSid, WORD wNumStrings, DWORD dwDataSize,  LPCWSTR* lpStrings, LPVOID lpRawData);
ReportEventW 函数写入一个事件到指定的事件日志末尾。该函数同 WinNT 的同名函数一致，但参数 lpUserSid 估计是保留的 (应为 NULL)。

HANDLE WINAPI RegisterEventSourceW(LPCWSTR lpUNCServerName,  LPCWSTR lpSourceName);
RegisterEventSourceW 函数获取指定的事件日志的已注册句柄。该函数同 WinNT 的同名函数一致，但参数 lpUNCServerName 估计是保留的 (应为 NULL)。

BOOL WINAPI DeregisterEventSource(HANDLE hEventLog);
DeregisterEventSource 函数关闭指定的事件日志的写入句柄。该函数同 WinNT 的同名函数一致。

BOOL WINAPI ClearEventLogW(HANDLE hEventLog, LPCWSTR lpBackupFileName);
ClearEventLogW 函数清除指定的事件日志，亦可以将日志的当前副本保存到备份文件。该函数同 WinNT 的同名函数一致。

HANDLE WINAPI OpenEventLogW(LPCTSTR lpUNCServerName, LPCTSTR lpSourceName);
OpenEventLogW 函数打开指定的事件日志句柄。该函数同 WinNT 的同名函数一致，但参数 lpUNCServerName 估计是保留的 (应为 NULL)。

BOOL WINAPI CloseEventLog(HANDLE hEventLog);
CloseEventLog 函数关闭指定的事件日志的读取句柄。该函数同 WinNT 的同名函数一致。

BOOL WINAPI BackupEventLogW(HANDLE hEventLog, LPCTSTR szBackupFileName);
BackupEventLogW 函数保存指定的事件日志到备份文件。该函数同 WinNT 的同名函数一致。

BOOL WINAPI LockEventLog(HANDLE hEventLog);
LockEventLog 函数锁定指定事件日志用来互斥访问。该函数是 Windows CE 专用函数。

BOOL WINAPI UnLockEventLog(HANDLE hEventLog);
UnLockEventLog 函数解除指定事件日志的锁定。该函数是 Windows CE 专用函数。

BOOL WINAPI ReadEventLogRaw(HANDLE hEventLog, BYTE *pReadBuffer, DWORD dwReadBufferSize, DWORD *pdwBytesRead);
ReadEventLogRaw 函数从指定的事件日志读取原始数据。该函数是 Windows CE 专用函数。