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

プロパティ配列の要素にアクセスするための 0 から始まるインデックス。 プロパティ データが配列ではない場合、または配列全体に対応する場合は、ULONG_MAX (0xFFFFFFFF) を指定します。

Reserved

予約済み。

注釈

構造体を記述するには、PropertyName に構造体の名前を設定し、ArrayIndex をULONG_MAXします。

構造体のメンバーを記述するには、2 つの PROPERTY_DATA_DESCRIPTOR 構造体の配列を定義します。 最初の記述子で、PropertyName を構造体の名前に設定し、ArrayIndex を 0 に設定します。 2 番目の記述子で、PropertyName にメンバーの名前を設定し、ArrayIndex をULONG_MAXに設定します。

構造体が構造体の配列の要素である場合は、最初の記述子の ArrayIndex を配列内の構造体の 0 から始まるインデックスに設定します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	tdh.h

こちらもご覧ください

TdhGetProperty

TdhGetPropertySize