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 數據類型 | Description |
|---|---|---|
| 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 |