Share via

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

另請參閱

TdhGetProperty

TdhGetPropertySize