ProviderType 复杂类型
定义提供程序及其用于定义其事件的元数据。
<xs:complexType name="ProviderType">
<xs:choice
minOccurs="0"
maxOccurs="unbounded"
>
<xs:element name="channels"
type="ChannelListType"
/>
<xs:element name="levels"
type="LevelListType"
/>
<xs:element name="tasks"
type="TaskListType"
/>
<xs:element name="opcodes"
type="OpcodeListType"
/>
<xs:element name="keywords"
type="KeywordListType"
/>
<xs:element name="maps"
type="MapType"
/>
<xs:element name="namedQueries"
type="NamedQueryType"
/>
<xs:element name="templates"
type="TemplateListType"
/>
<xs:element name="events"
type="DefinitionType"
/>
<xs:element name="filters"
type="FilterListType"
/>
<xs:any
processContents="lax"
namespace="##other"
/>
</xs:choice>
<xs:attribute name="name"
type="anyURI"
use="required"
/>
<xs:attribute name="guid"
type="GUIDType"
use="required"
/>
<xs:attribute name="resourceFileName"
type="filePath"
use="optional"
/>
<xs:attribute name="messageFileName"
type="filePath"
use="optional"
/>
<xs:attribute name="parameterFileName"
type="filePath"
use="optional"
/>
<xs:attribute name="helpLink"
type="anyURI"
use="optional"
/>
<xs:attribute name="symbol"
type="CSymbolType"
use="required"
/>
<xs:attribute name="message"
type="strTableRef"
use="optional"
/>
<xs:attribute name="source"
use="optional"
default="Xml"
>
<xs:simpleType>
<xs:restriction
base="xs:string"
>
<xs:enumeration
value="Xml"
/>
<xs:enumeration
value="Wbem"
/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="warnOnApplicationCompatibilityError"
type="xs:boolean"
use="optional"
default="false"
/>
<xs:anyAttribute
processContents="lax"
namespace="##other"
/>
</xs:complexType>
子元素
元素 | 类型 | 说明 |
---|---|---|
channels | ChannelListType | 定义提供程序可以将事件记录到的通道列表。 |
事件 | DefinitionType | 定义提供程序可以记录的事件的事件定义的列表。 |
过滤 器 | FilterListType | 定义提供程序支持的筛选器列表。 可以像使用 level 和 关键字一样使用筛选器来确定是否要编写事件。 Windows Server 2008 和 Windows Vista: 在 Windows 7 之前不受支持。 |
关键 字 | KeywordListType | 定义对事件进行分类的关键字列表。 |
水平 | LevelListType | 定义一个级别列表,这些级别指定事件的严重性。 |
地图 | MapType | 定义可在清单的模板节中引用的名称/值对列表。 |
namedQueries | NamedQueryType | 未使用。 定义一个命名查询列表,这些查询在事件消息字符串中查询值,并在找到时执行指定的操作。 |
opcodes | OpcodeListType | 定义可用于对任务中的事件进行分组的操作码列表。 |
任务 | TaskListType | 定义提供程序可用于对事件进行分组的任务列表。 通常,使用任务对提供程序的功能或组件的事件进行分组。 |
模板 | TemplateListType | 定义模板列表,这些模板指定要包含在事件中的数据。 |
属性
名称 | 类型 | 说明 |
---|---|---|
guid | GUIDType | 唯一标识提供程序的 GUID。 |
helpLink | anyURI | URL 或 MS 帮助链接到提供有关提供程序引发的事件的信息的内容。 |
message | strTableRef | 提供程序的本地化显示名称。 消息字符串引用清单的 stringTable 节中的本地化字符串。 |
messageFileName | filePath | 包含提供程序的本地化消息资源的文件的完整路径。 该文件可以是可执行文件或 DLL 文件。 |
name | anyURI | 提供程序的名称。 名称应采用 公司-产品-组件的形式。 名称不能超过 255 个字符,并且不能包含以下字符:“”、“>'<&”、“'”、“|”、“\”、“:”、“”、“”、“?”、“*”或代码小于 31 的字符。 此外,该名称必须遵循对文件和注册表项名称的一般约束。 可以在命名文件和注册表元素大小限制中找到这些约束。 |
parameterFileName | filePath | 包含提供程序的参数字符串资源的文件的完整路径。 该文件可以是可执行文件或 DLL 文件。 可以指定多个用分号分隔的参数文件。 当事件的消息字符串包含参数字符串时,将搜索该文件。 使用参数可以提供可本地化的插入字符串。 有关更多信息,请参见备注。 |
resourceFileName | filePath | 包含提供程序的元数据资源的文件的完整路径。 该文件可以是可执行文件或 DLL 文件。 |
source | 仅限内部使用。 |
|
符号 | CSymbolType | 用于在应用程序中引用提供程序的 GUID 的符号。
消息编译器 (MC.exe) 使用 符号在编译器生成的头文件中为提供程序的 GUID 创建常量。 |
warnOnApplicationCompatibilityError | xs: boolean | 仅限内部使用。 |
备注
Windows 事件查看器 (Eventvwr.exe) 将使用本地化的消息字符串(如果可用);否则,它将使用 name 属性中的字符串。
resourceFileName、messageFileName 和 parameterFileName 的路径可以包含环境变量。 如果定义要在路径中使用的新环境变量,则必须重新启动计算机,以便事件日志服务能够选取新变量;否则,服务将无法找到提供程序的资源。
事件的消息字符串可以包含插入字符串和参数字符串。 插入字符串的格式为 %n,其中 n 是从 1 开始的索引,用于标识要插入消息的事件数据模板中的数据项。 参数字符串 (parameterFileName 属性) 的格式为 %%n,其中 n 是消息表中消息的标识符。 如果事件的消息字符串包含“%1 %%11 = %2 %%12”,并且 %1 和 %2 的数据项值分别为 8 和 2,并且 %%11 和 %%12 的参数字符串分别为“quarts”和“gallons”,则格式化字符串将为“8 quarts = 2 加仑”。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |