структура PROPERTY_DATA_DESCRIPTOR (tdh.h)
Определяет извлекаемое свойство.
Синтаксис
typedef struct _PROPERTY_DATA_DESCRIPTOR {
ULONGLONG PropertyName;
ULONG ArrayIndex;
ULONG Reserved;
} PROPERTY_DATA_DESCRIPTOR;
Члены
PropertyName
Указатель на строку Юникода с пустым завершением, которая содержит имя свойства с учетом регистра. Для получения имени свойства можно использовать элемент NameOffsetструктуры EVENT_PROPERTY_INFO .
В следующей таблице перечислены возможные значения PropertyName для событий WPP. Используйте предлагаемый тип данных TDH при форматировании возвращаемого буфера из TdhGetProperty.
| Имя | Тип данных 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 | Guid, связанный с сообщением трассировки WPP. |
| 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 |