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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Das DataPtr-Element verweist auf ein erweitertes Headerelement, das TraceLogging-Ereignismetadateninformationen enthält. |
|
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. |
|
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. |
|
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) |