Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |