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


Сложный тип EventDefinitionType

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

<xs:complexType name="EventDefinitionType">
    <xs:simpleContent>
        <xs:extension
            base="string"
        >
            <xs:attribute name="value"
                type="UInt32Type"
                use="required"
             />
            <xs:attribute name="level"
                type="QName"
                use="optional"
             />
            <xs:attribute name="template"
                type="token"
                use="optional"
             />
            <xs:attribute name="channel"
                type="token"
                use="optional"
             />
            <xs:attribute name="keywords"
                type="QNameList"
                use="optional"
             />
            <xs:attribute name="task"
                type="QName"
                use="optional"
             />
            <xs:attribute name="opcode"
                type="QName"
                use="optional"
             />
            <xs:attribute name="symbol"
                type="CSymbolType"
                use="optional"
             />
            <xs:attribute name="version"
                type="unsignedByte"
                use="optional"
             />
            <xs:attribute name="message"
                type="strTableRef"
                use="optional"
             />
            <xs:attribute name="notLogged"
                type="boolean"
                use="optional"
                default="false"
             />
        </xs:extension>
    </xs:simpleContent>
</xs:complexType>

Атрибуты

Имя Тип Описание
channel token Идентификатор, определяющий канал, в который записывается событие. Укажите идентификатор одного из определенных или импортированных каналов. Если в канале не указан идентификатор канала, используйте имя канала. Дополнительные сведения об определении или импорте канала см. в разделе Сложный тип ChannelListType .
Если канал не указан, событие не записывается в канал. Как правило, единственная причина не указывать канал заключается в том, что вы записываете события только в сеанс трассировки событий Windows. Дополнительные сведения см. в разделе Создание сеанса трассировки событий Windows в разделе Управление сеансами трассировки событий.
keywords QNameList Разделенный пробелами список имен ключевое слово, определяющих категорию событий, к которым принадлежит это событие. Укажите имя ключевое слово из списка ключевых слов, которые вы определяете. Дополнительные сведения об определении ключевых слов см. в разделе Сложный тип KeywordType .
Если не указать ключевые слова, дескриптор события будет содержать ноль для ключевых слов.
уровень QName Уровень детализации, используемый при записи события. Укажите имя уровня, определенного в манифесте, или один из уровней, определенных в файле \Include\Winmeta.xml, включенном в пакет WINDOWS SDK. Дополнительные сведения об определении уровня см. в разделе Сложный тип LevelType .
Если уровень не указан, дескриптор события будет содержать ноль для уровня.
Необходимо указать уровень, если тип канала, в который записывается событие, Администратор; уровень должен быть одним из следующих уровней, определенных в Winmeata.xml:
  • win:Critical
  • win:Error
  • win:Warning
  • win:Informational

message strTableRef Локализованное сообщение для события. Строка сообщения ссылается на локализованную строку в разделе stringTable манифеста.
Если тип канала, в который записывается событие, Администратор, необходимо указать сообщение.
NotLogged Логическое Определяет, регистрирует ли поставщик это событие. Укажите значение true, если поставщик регистрирует это событие; в противном случае — false. Используйте этот атрибут, чтобы указать, что поставщик больше не регистрировать это событие вместо удаления события из манифеста. Сохранение события в манифесте позволит потребителям декодировать старые ETL-файлы, включающие событие.
Windows Server 2008 и Windows Vista: Этот атрибут не поддерживается в версиях компилятора сообщений, которые поставлялись до версии Windows 7 windows SDK.
Код QName Имя кода операции, идентифицирующий операцию в задаче. Укажите имя кода операции, определенного в манифесте, или один из кодов операций, определенных в Winmeta.xml. Дополнительные сведения об определении кода операции см. в разделе Сложный тип OpcodeType .
Если задача, на которую вы ссылаетесь, содержит коды операций для конкретной задачи (локальные), можно указать один из кодов операций для конкретной задачи или код операции, определенный на уровне поставщика (глобальный код операции). Если указать глобальный код операции, значение глобального кода операции не может совпадать с одним из локальных кодов операций для задачи.
Если вы ссылаетесь на локальный код операции, атрибут задачи должен ссылаться на задачу, которой принадлежит локальный код операции.
Если не указать код операции, дескриптор события будет содержать ноль для кода операции.
символ CSymbolType Символ, используемый для ссылки на дескриптор события для этого события в приложении. Компилятор сообщений (MC.exe) использует символ для создания константы для дескриптора события в файле заголовка, создаваемом компилятором. Если не указать символ, компилятор создаст его автоматически. Дескриптор используется при вызове функции EventWrite для записи события.
задача QName Имя задачи, которая идентифицирует компонент или подкомпонент, создающий это событие. Укажите имя задачи, определенной в манифесте. Дополнительные сведения об определении задачи см. в разделе Сложный тип TaskType .
Если задача не указана, дескриптор события будет содержать ноль для задачи.
шаблон token Идентификатор шаблона, определяющий элементы данных, которые включает это событие. Укажите идентификатор шаблона, определенного в манифесте. Дополнительные сведения об определении шаблона см. в разделе Сложный тип TemplateItemType .
значение UInt32Type Идентификатор события. Идентификатор должен быть уникальным в пределах списка событий, который вы определяете.
version unsignedByte Однобайтовой номер версии определения события.

Комментарии

Если вы используете EvtFormatMessage для форматирования строки сообщения для события (или используете Просмотр событий для просмотра строки сообщения), строка сообщения может содержать строки вставки и любые строки форматирования, поддерживаемые функцией Win32 FormatMessage. Строки вставки ограничены %n или %n!s! (например, %1), где n — это одноуровневая ссылка на элементы данных, определенные в шаблоне события. Строка сообщения также может содержать строки вставки параметров в формате %%n (например, %%4). Максимальное число строк вставки, которое может содержать сообщение, равно 100.

Требования

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