EVENT_HEADER_EXTENDED_DATA_ITEM Struktur (relogger.h)

Artikel
08/25/2023

Die EVENT_HEADER_EXTENDED_DATA_ITEM-Struktur definiert die erweiterten Daten, die ETW als Teil der Ereignisdaten sammelt.

Syntax

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  USHORT    Linkage;
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

Members

Reserved1

Reserviert.

ExtType

Typ der erweiterten Daten. Im Folgenden sind mögliche Werte aufgeführt.

Wert	Bedeutung
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID Struktur, die den zugehörigen Aktivitätsbezeichner enthält, wenn Sie EventWriteTransfer aufgerufen haben, um das Ereignis zu schreiben.
EVENT_HEADER_EXT_TYPE_SID	Das DataPtr-Element verweist auf eine SID-Struktur , die den Sicherheitsbezeichner (SID) des Benutzers enthält, der das Ereignis protokolliert hat. ETW enthält die SID, wenn Sie den EnableProperty-Parameter von EnableTraceEx auf EVENT_ENABLE_PROPERTY_SID festlegen.
EVENT_HEADER_EXT_TYPE_TS_ID	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_TS_ID-Struktur , die den Terminalsitzungsbezeichner enthält. ETW enthält den Terminalsitzungsbezeichner, wenn Sie den EnableProperty-Parameter von EnableTraceEx auf EVENT_ENABLE_PROPERTY_TS_ID festlegen.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_INSTANCE Struktur, die den Aktivitätsbezeichner enthält, wenn Sie TraceEventInstance aufgerufen haben, um das Ereignis zu schreiben.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_STACK_TRACE32-Struktur , die den Aufrufstapel enthält, wenn das Ereignis auf einem 32-Bit-Computer erfasst wird.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_STACK_TRACE64 Struktur, die den Aufrufstapel enthält, wenn das Ereignis auf einem 64-Bit-Computer erfasst wird.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL	Das DataPtr-Element verweist auf ein erweitertes Headerelement, das TraceLogging-Ereignismetadateninformationen enthält.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS	Das DataPtr-Element verweist auf ein erweitertes Headerelement, das Anbietermerkmale enthält, z. B. Merkmale, die über EventSetInformation(EventProviderSetTraits) festgelegt oder über EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA angegeben werden.
EVENT_HEADER_EXT_TYPE_EVENT_KEY	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_EVENT_KEY-Struktur, die einen eindeutigen Ereignisbezeichner enthält, bei dem es sich um einen 64-Bit-Skalar handelt. Die EnableProperty-EVENT_ENABLE_PROPERTY_EVENT_KEY muss für den EnableTrace-Aufruf für einen bestimmten Anbieter übergeben werden, um dieses Feature zu aktivieren.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY	Das DataPtr-Element verweist auf eine EVENT_EXTENDED_ITEM_PROCESS_START_KEY-Struktur, die einen eindeutigen Prozessbezeichner (eindeutig für die Startsitzung) enthält. Dieser Bezeichner ist ein 64-Bit-Skalar. Die EnableProperty-EVENT_ENABLE_PROPERTY_PROCESS_START_KEY muss für den EnableTrace-Aufruf für einen bestimmten Anbieter übergeben werden, um dieses Feature zu aktivieren.

Linkage

Reserviert.

DataSize

Größe der erweiterten Daten, auf die DataPtr verweist, in Bytes.

DataPtr

Zeiger auf die erweiterten Daten. Das ExtType-Element bestimmt den Typ der erweiterten Daten, auf die dieses Element verweist.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	relogger.h (include Evntcons.h)

Weitere Informationen

EVENT_RECORD