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 [仅限桌面应用]