PROPERTY_DATA_DESCRIPTOR-Struktur (tdh.h)
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 |