EVENT_DESCRIPTOR 结构 (relogger.h)

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

应用程序或组件 (中更大的工作单元比 Opcode) 更广。

Keyword

指定相关事件的逻辑组的位掩码。 每个位对应于一个组。 事件可能属于一个或多个组。 关键字可以包含一个或多个提供程序定义的关键字和/或标准关键字。

注解

此结构表示清单中定义的事件。 不声明和填充此结构,而是使用 消息编译器 (MC.exe) 生成头文件,该文件声明并填充清单中的每个事件。 有关编写清单和生成头文件的详细信息,请参阅 编写检测清单编译检测清单

有关此结构的成员的详细信息,请参阅 EventDefinitionType 复杂类型的属性。

调用 EventWriteEventWriteTransfer 以写入事件时,可以指定此结构。 还可以在调用 EventEnabled 时使用它来确定是否应编写事件。

此结构还包含在使用 EventRecordCallback 回调使用事件时随事件记录一起返回的 EVENT_HEADER 结构中。 对于 MOF 定义的事件, Opcode 成员包含事件类型值。 VersionLevel 成员包含预期信息。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 relogger.h (包括 Evntprov.h)

另请参阅

EVENT_HEADER

EventDescCreate

EventDescGetChannel

EventDescGetId

EventDescGetKeyword

EventDescGetLevel

EventDescGetOpcode

EventDescGetTask

EventDescGetVersion

EventDescOrKeyword

EventDescSetChannel

EventDescSetId

EventDescSetKeyword

EventDescSetLevel

EventDescSetOpcode

EventDescSetTask

EventDescSetVersion

EventDescZero

EventEnabled

EventWrite

EventWriteTransfer

PROVIDER_EVENT_INFO

TdhEnumerateManifestProviderEvents

TdhGetManifestEventInformation