структура EVENT_DESCRIPTOR (relogger.h)

Статья
08/25/2023

Структура EVENT_DESCRIPTOR содержит метаданные, определяющие событие.

Синтаксис

typedef struct _EVENT_DESCRIPTOR {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Channel;
  UCHAR     Level;
  UCHAR     Opcode;
  USHORT    Task;
  ULONGLONG Keyword;
} EVENT_DESCRIPTOR, *PEVENT_DESCRIPTOR;

Члены

Id

Идентификатор события.

Version

Версия события. Эта версия указывает редакцию для определения события. Этот элемент и элемент Id можно использовать для уникальной идентификации события в область поставщика.

Channel

Аудитория события (например, администратор или разработчик).

Level

Серьезность или уровень детализации, включенные в событие (например, информационное или неустранимое).

Opcode

Шаг в последовательности операций, выполняемых в рамках задачи.

Task

Более крупная единица работы в приложении или компоненте (шире, чем в коде операций).

Keyword

Битовая маска, задающая логическую группу связанных событий. Каждый бит соответствует одной группе. Событие может принадлежать одной или нескольким группам. Ключевое слово может содержать одно или несколько определяемых поставщиком или стандартных ключевых слов либо их сочетание.

Эта структура представляет событие, определенное в манифесте. Вы не объявляете и не заполняете эту структуру, вместо этого используется компилятор сообщений (MC.exe) для создания файла заголовка, который объявляет и заполняет эту структуру для каждого события в манифесте. Дополнительные сведения о написании манифеста и создании файла заголовка см. в разделах Написание манифеста инструментирования и Компиляция манифеста инструментирования.

Дополнительные сведения об элементах этой структуры см. в атрибутах сложного типа EventDefinitionType .

Эта структура указывается при вызове EventWrite или EventWriteTransfer для записи события. Его также можно использовать при вызове EventEnabled , чтобы определить, следует ли записывать событие.

Эта структура также включена в структуру EVENT_HEADER , которая возвращается с записью события при использовании событий с помощью обратного вызова EventRecordCallback . Для событий, определяемых MOF, элемент Opcode содержит значение типа события. Элементы Version и Level содержат ожидаемые сведения.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	relogger.h (включая Evntprov.h)