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

最新推荐文章于 2023-07-11 10:08:39 发布

原创最新推荐文章于 2023-07-11 10:08:39 发布 · 1.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#winapi #windows #null #logging #byte #api

Windows CE / Mobile 专栏收录该内容

23 篇文章

订阅专栏

本文详细介绍了Windows CE的Event Logging API，包括ReportEventW、RegisterEventSourceW、DeregisterEventSource等10个关键函数的用法。这些函数与WinNT版本相似，但某些参数在Windows CE中可能被保留。例如，lpUserSid和lpUNCServerName通常应设置为NULL。文章还提及了特定于Windows CE的LockEventLog和UnLockEventLog函数，用于互斥访问事件日志。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

*《【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 专用函数。