c++写入应用程序日志（Event Log ）

日志文件是操作系统的一部分，那么肯定有应用程序编程接口（API）来支持建立日志记录

 

实例：

 HANDLE h;
 if ((h = RegisterEventSource(NULL,TEXT("MetaLive"))) == NULL)
 {
  return FALSE;
 }
 const char* ps = "pszS1pszS2pszS3";
 WORD wType=EVENTLOG_ERROR_TYPE;//EVENTLOG_INFORMATION_TYPE;
 DWORD dwID=5001;
 int iStr = 1;
 BOOL bRet;
 DWORD dword;
 if (h)
 {
  bRet=::ReportEvent(h,
       wType,
       0,
       dwID,
       NULL, // sid
       iStr,
       0,
       &ps,
       NULL);

  dword=::GetLastError();
 }
 //

 

 

 

基于 Windows XP 的计算机将事件记录在以下三种日志中：

1. 应用程序日志

应用程序日志包含由程序记录的事件。例如，数据库程序可能在应用程序日志中记录文件错误。写入到应用程序
日志中的事件是由软件程序开发人员确定的。

2. 安全日志

安全日志记录有效和无效的登录尝试等事件，以及与资源使用有关的事件（如创建、打开或删除文件）。例如，

在启用登录审核的情况下，每当用户尝试登录到计算机上时，都会在安全日志中记录一个事件。您必须以 Administrator

或 Administrators 组成员的身份登录，才能打开、使用安全日志以及指定将哪些事件记录在安全日志中。

3. 系统日志

系统日志包含 Windows XP 系统组件所记录的事件。例如，如果在启动过程中未能加载某个驱动程序，则会在

系统日志中记录一个事件。Windows XP 预先确定由系统组件记录的事件。

本文，我们专注于第一类应用程序日志，介绍如何写入一条EventLog。Windows使用ReportEvent 报告应用程序消息，

下面就对这个函数做点简单的介绍。

    HANDLE hEventLog, // RegisterEventSource返回的handle     WORD wType, // 要记录的事件类型     WORD wCategory, // 事件种类     DWORD dwEventID, // 事件标示     PSID lpUserSid, // 用户安全标示（可选）     WORD wNumStrings, // 消息的字符串数     DWORD dwDataSize, // 以字节为单位的二进制数据的大小     LPCTSTR *lpStrings, // 消息本身     LPVOID lpRawData  // 二进制数据   );

 

Parameters

hEventLog
事件标志。这个是 RegisterEventSource 返回的handle.

wType
事件的类型。可以是如下中的一个：
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

wCategory
指出消息种类。这个地方是由源自己定义的，可以是任何值。

dwEventID
事件标识。根据我的理解，这里的标识在使用时，会又源解释为具体的含义。比如：2001表示文件打开错误等等。
因此，要想设定完整的Event Log还需要在系统中注册一个解释的服务程序。示例程序并没有设计这个服务，
读者可以参考另外的那个VB程序。

lpUserSid
指向用户安全标示。当不需要安全标示时，该参数可以为NULL.

wNumStrings
给定lpStrings 指向的数组中字符串组的数量。0表示当前没有字符串组。

dwDataSize
给出将写入Evenet Log的数据的大小，以字节为单位。如果这个参数为0，表示当前没有事件数据。

lpStrings
指向一个缓冲区，其中是一个以0为结尾的字符串数组，这个数组将会添加到消息中。即使dwDataSize 参数为0，
这个参数也必须是有效的指针（或者为NULL）。数组中每个字符串最大为32K 字节。

lpRawData
指向包含二进制数据的缓冲区。即使dwDataSize 参数为0，该项也必须是一个有效的指针（或者为NULL）.

Return Values
如果执行成功，返回非零值，表示事件入口已经写入日志。
如果执行不成功，返回0.