PROPERTY_DATA_DESCRIPTOR-Struktur (tdh.h)

  • Artikel

Definiert die abzurufende Eigenschaft.

Syntax

typedef struct _PROPERTY_DATA_DESCRIPTOR {
  ULONGLONG PropertyName;
  ULONG     ArrayIndex;
  ULONG     Reserved;
} PROPERTY_DATA_DESCRIPTOR;

Member

PropertyName

Zeiger auf eine unicode-Zeichenfolge mit Null-Ende, die den Eigenschaftsnamen enthält, bei dem die Groß-/Kleinschreibung beachtet wird. Sie können das NameOffset-Element der EVENT_PROPERTY_INFO-Struktur verwenden, um den Eigenschaftennamen abzurufen.

In der folgenden Tabelle sind die möglichen Werte von PropertyName für WPP-Ereignisse aufgeführt. Verwenden Sie den vorgeschlagenen TDH-Datentyp, wenn Sie den zurückgegebenen Puffer von TdhGetProperty formatieren.

Name TDH-Datentyp BESCHREIBUNG
FormattedString TDH_INTYPE_UNICODESTRING Die formatierte WPP-Ablaufverfolgungsmeldung.
SequenceNum TDH_INTYPE_UINT32 Die lokale oder globale Sequenznummer der Ablaufverfolgungsnachricht. Die Standardeinstellung sind lokale Sequenznummern, die nur für diese Ablaufverfolgungssitzung eindeutig sind.
FunctionName TDH_INTYPE_UNICODESTRING Der Name der Funktion, die die Ablaufverfolgungsmeldung generiert hat.
ComponentName TDH_INTYPE_UNICODESTRING Der Name der Komponente des Anbieters, der die Ablaufverfolgungsnachricht generiert hat. Der Komponentenname wird nur angezeigt, wenn er im Ablaufverfolgungscode angegeben ist.
SubComponentName TDH_INTYPE_UNICODESTRING Der Name der Teilkomponente des Anbieters, der die Ablaufverfolgungsnachricht generiert hat. Der Unterkomponentenname wird nur angezeigt, wenn er im Ablaufverfolgungscode angegeben ist.
TraceGuid TDH_INTYPE_GUID Die GUID, die der WPP-Ablaufverfolgungsmeldung zugeordnet ist.
GuidTypeName TDH_INTYPE_UNICODESTRING Der Dateiname, der mit der Zeilennummer aus dem Quellcode verkettet ist, von dem aus die WPP-Ablaufverfolgungsmeldung nachverfolgt wurde.
SystemTime TDH_INTYPE_SYSTEMTIME Der Zeitpunkt, zu dem die WPP-Ablaufverfolgungsmeldung generiert wurde.
FlagsName TDH_INTYPE_UNICODESTRING Die Namen der Ablaufverfolgungsflags, die die Ablaufverfolgungsnachricht aktivieren.
LevelName TDH_INTYPE_UNICODESTRING Der Wert der Ablaufverfolgungsebene, die die Ablaufverfolgungsmeldung aktiviert.

ArrayIndex

Nullbasierter Index für den Zugriff auf Elemente eines Eigenschaftenarrays. Wenn die Eigenschaftendaten kein Array sind oder Sie das gesamte Array adressieren möchten, geben Sie ULONG_MAX (0xFFFFFFFF) an.

Reserved

Reserviert.

Hinweise

Um eine Struktur zu beschreiben, legen Sie PropertyName auf den Namen der Struktur und ArrayIndex auf ULONG_MAX fest.

Um ein Element einer Struktur zu beschreiben, definieren Sie ein Array aus zwei PROPERTY_DATA_DESCRIPTOR Strukturen. Legen Sie im ersten Deskriptor PropertyName auf den Namen der Struktur und ArrayIndex auf 0 fest. Legen Sie im zweiten Deskriptor PropertyName auf den Namen des Members und ArrayIndex auf ULONG_MAX fest.

Wenn die Struktur ein Element eines Arrays von Strukturen ist, legen Sie ArrayIndex im ersten Deskriptor auf den nullbasierten Index der Struktur im Array fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile tdh.h

Weitere Informationen

TdhGetProperty

TdhGetPropertySize