PROPERTY_DATA_DESCRIPTOR 结构 (tdh.h)
定义要检索的属性。
语法
typedef struct _PROPERTY_DATA_DESCRIPTOR {
ULONGLONG PropertyName;
ULONG ArrayIndex;
ULONG Reserved;
} PROPERTY_DATA_DESCRIPTOR;
成员
PropertyName
指向以 null 结尾的 Unicode 字符串的指针，该字符串包含区分大小写的属性名称。 可以使用 EVENT_PROPERTY_INFO 结构的 NameOffset 成员来获取属性名称。
下表列出了 WPP 事件的 PropertyName 的可能值。 设置 TdhGetProperty 中返回的缓冲区的格式时，请使用建议的 TDH 数据类型。
| 名称 | TDH 数据类型 | 说明 |
|---|---|---|
| FormattedString | TDH_INTYPE_UNICODESTRING | 格式化的 WPP 跟踪消息。 |
| SequenceNum | TDH_INTYPE_UINT32 | 跟踪消息的本地或全局序列号。 本地序列号（仅对此跟踪会话是唯一的）是默认值。 |
| FunctionName | TDH_INTYPE_UNICODESTRING | 生成跟踪消息的函数的名称。 |
| ComponentName | TDH_INTYPE_UNICODESTRING | 生成跟踪消息的提供程序的组件的名称。 仅当在跟踪代码中指定组件名称时，才会显示该名称。 |
| SubComponentName | TDH_INTYPE_UNICODESTRING | 生成跟踪消息的提供程序的子组件的名称。 子组件名称仅在跟踪代码中指定时才显示。 |
| TraceGuid | TDH_INTYPE_GUID | 与 WPP 跟踪消息关联的 GUID。 |
| GuidTypeName | TDH_INTYPE_UNICODESTRING | 文件名与从中跟踪 WPP 跟踪消息的源代码中的行号连接。 |
| SystemTime | TDH_INTYPE_SYSTEMTIME | 生成 WPP 跟踪消息的时间。 |
| FlagsName | TDH_INTYPE_UNICODESTRING | 启用跟踪消息的跟踪标志的名称。 |
| LevelName | TDH_INTYPE_UNICODESTRING | 启用跟踪消息的跟踪级别的值。 |
ArrayIndex
用于访问属性数组元素的从零开始的索引。 如果属性数据不是数组，或者如果要寻址整个数组，请指定ULONG_MAX (0xFFFFFFFF) 。
Reserved
保留。
注解
若要描述结构，请将 PropertyName 设置为结构的名称，将 ArrayIndex 设置为 ULONG_MAX。
若要描述结构的成员，请定义包含两个 PROPERTY_DATA_DESCRIPTOR 结构的数组。 在第一个描述符中，将 PropertyName 设置为结构的名称，将 ArrayIndex 设置为 0。 在第二个描述符中，将 PropertyName 设置为成员的名称，将 ArrayIndex 设置为 ULONG_MAX。
如果结构是结构数组的元素，请将第一个描述符中的 ArrayIndex 设置为数组中结构的从零开始的索引。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 标头 | tdh.h |