就Windows开发者及系统管理员来说,Windows Vista日志相比以前,无疑有了一个很大的提高。对开发者来说,Vista的日志记录对多种事件与日志选项,都表现出统一一致性;而对网络管理员及IT专家,它提供了丰富的人机界面用于管理事件。新的日志记录方式,也只能通过Windows SDK中新的本机函数来实现,下面就来看看怎样在程序中实现新的记录方式。
创建并编译清单文件
如果程序中使用了新的API,且要把事件记录到日志中,就需要创建一个清单文件(这里补充一点,如果未使用新的API,或仅是使用托管程序,日志记录还是继续使用原来的ReportEvent* API)。清单文件是程序中所有事件基于XML格式的表现形式,我们可使用命令行的消息编译器(MC.exe),利用清单文件来生成一个头文件(*.h)及一个资源文件(*.rc)——仅限于用在C++工程中。(有关事件日志清单文件的详细说明,请查阅MSDN联机文档,在本文中只提及了其中的一小部分。)
在清单文件中,最重要的元素就是指明了哪个“通道”(channel)可以被写入,“通道”是Vista事件日志中一个新的概念,它根据接收者及卷,为事件提供了单独的输出。示例程序中使用了两个通道:操作性(Operational)通道及调试(Debug)通道,以下的XML指定了程序将使用这两种通道来引发事件:
<channels> <importChannel chid="C1" name="Application"/> <channel chid="MyOpChannel" name="DotNetPerformance-TechalWriting-EventLogSample/ Operational" type="Operational" symbol="DOTNETPERFORMANCE" isolation="Application" enabled="true"/> <channel chid="MyDebugChannel" name="DotNetPerformance-TechalWriting-EventLogSample/ Debug" type="Debug" symbol="DOTNETPERFORMANCE" isolation="Application" enabled="true"/> |
在定义好通道之后,下一步就是定义一个模板以指定要引发事件的基本形态。与原来的事件日志API类似,Vista事件日志也支持使用%1这样的通配符,以便可替换为本地化语言的文本,这样,消息文本的所有内容都可在运行时才提供:
<template tid="SimpleEvent" message="$(string.SimpleMessage)"> <data name="Message" inType="win:UnicodeString"/> <UserData> <SimpleEvent xmlns="http://manifests.microsoft.com/ win/2004/08/windows/simpleevent"> <ExceptionMessage>%1</ExceptionMessage> </SimpleEvent> </UserData> </template> |
最后,还需要把应用程序实际将引发的事件添加到清单文件中,为简单起见,对每个通道只定义了一个事件,且都使用同一个模板:
<event value="1" level="win:Informational" template="SimpleEvent" opcode="win:Info" channel="MyOpChannel" symbol=" DNP_OP_EVENT" message="$(string.SimpleMessage)"/> <event value="2" level="win:Informational" template="SimpleEvent" opcode="win:Info" channel="MyDebugChannel" symbol=" DNP_DEBUG_EVENT" message="$(string.SimpleMessage)"/> |
现在,消息编译器(mc.exe)就可以把这个清单文件编译为头文件及资源文件了。