Сложный тип ProviderType

Статья
01/10/2024

Определяет поставщика и метаданные, которые он использует для определения событий.

<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	Определяет список фильтров, поддерживаемых поставщиком. Фильтры можно использовать так же, как и ключевое слово, чтобы определить, хотите ли вы написать событие. Windows Server 2008 и Windows Vista: не поддерживается до Windows 7.
ключевое слово	KeywordListType	Определяет список ключевое слово, которые классифицируют события.
Уровней	LevelListType	Определяет список уровней, определяющих серьезность события.
Карты	MapType	Определяет список пар "имя-значение", на которые можно ссылаться в разделе шаблона манифеста.
namedQueries	NamedQueryType	Не используется. Определяет список именованных запросов, которые запрашивают строку сообщения события для значения и выполняют указанное действие при обнаружении.
opcodes	OpcodeListType	Определяет список опкодов, которые можно использовать для группирования событий в задаче.
Задачи	TaskListType	Определяет список задач, которые поставщик может использовать для группирования событий. Как правило, задачи используются для группировки событий для компонента или компонента поставщика.
templates	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		Только для внутреннего пользования.
symbol	CSymbolType	Символ, используемый для ссылки на GUID поставщика в приложении. Компилятор сообщений (MC.exe) использует символ для создания константы для GUID поставщика в файле заголовка, который создает компилятор.
warnOnApplicationCompatibilityError	xs:boolean	Только для внутреннего пользования.

Замечания

Windows Просмотр событий (Eventvwr.exe) будет использовать локализованную строку сообщения, если она доступна; в противном случае она использует строку из атрибута имени.

Пути к resourceFileName, messageFileName и parameterFileName могут содержать переменные среды. Если вы определяете новую переменную среды для использования в пути, необходимо перезапустить компьютер, чтобы служба журналов событий может забрать новую переменную; в противном случае служба не сможет найти ресурсы поставщика.

Строка сообщения события может содержать строки вставки и строки параметров. Строка вставки имеет форму %n, где n — это одноуровневый индекс, определяющий элемент данных из шаблона данных события, который требуется вставить в сообщение. Строка параметра (см . атрибут parameterFileName ) имеет форму %%n, где n является идентификатором сообщения в таблице сообщений. Если строка сообщения события содержит "%1 %1 %11 = %2 %12", а значения элементов данных для %1 и %2 были 8 и 2 соответственно, а строки параметров для %%11 и %%12 были "кварты" и "галлоны", соответственно, форматированная строка будет "8 квартов = 2 галлона".

Requirements

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]

Поделиться через