在VC++程序中自定义Vista事件日志

就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）就可以把这个清单文件编译为头文件及资源文件了。