日志文件是操作系统的一部分,那么肯定有应用程序编程接口(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.