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 |