EVENT_HEADER_EXTENDED_DATA_ITEM-Struktur (evntcons.h)

Definiert die erweiterten Daten, die die Ereignisablaufverfolgung für Windows (ETW) als Teil der Ereignisdaten sammelt.

Syntax

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

Member

Reserved1

Reserviert.

ExtType

Typ der erweiterten Daten. Die folgenden Werte sind möglich.

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
Der DataPtr-Member verweist auf eine SID-Struktur , die die Sicherheits-ID (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 die Aufrufliste enthält, wenn das Ereignis auf einem 32-Bit-Computer erfasst wird.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
Das DataPtr-Element zeigt auf eine EVENT_EXTENDED_ITEM_STACK_TRACE64-Struktur , die die Aufrufliste 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, der ein 64-Bit-Skalar ist.

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 über die Startsitzung hinweg) 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.

Reserved2

Reserviert.

DataSize

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

DataPtr

Zeiger auf die erweiterten Daten. Der ExtType-Member bestimmt den Typ der erweiterten Daten, auf die dieser Member verweist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile evntcons.h (evntcons.h einschließen)

Weitere Informationen

EVENT_RECORD