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

另请参阅

TdhGetProperty

TdhGetPropertySize