IDebugFailureAnalysis2::SetExtensionCommand メソッド (extsfns.h)
SetExtensionCommand メソッドは、DebugFailureAnalysis オブジェクトで、指定したタグを持つ最初の FA エントリ を検索します。 指定したタグを持つ FA 項目が見つかると、FA 項目のデータ・ブロックを指定された拡張コマンド・ストリングに設定 (上書き) します。 このメソッドは、指定したタグを持つ FA エントリ を見つけられない場合は、そのタグを持つ新しい FA エントリを作成し、新しい FA エントリのデータ ブロックを指定された拡張コマンド文字列に設定します。
構文
PFA_ENTRY SetExtensionCommand(
FA_TAG Tag,
PCSTR Extension
);
パラメーター
Tag
FA_TAG 列挙体の値。
Extension
拡張コマンドである null で終わる文字列へのポインター。 拡張コマンドの例として、"!analyze -v" があります。
戻り値
このメソッドが成功すると、新規または既存の FA_ENTRY 構造体へのポインターが返されます。 それ以外の場合は、null 返します。
備考
このメソッドは、指定したタグを持つ FA エントリ を検索する場合は、そのタグに関連付けられているデータ型が DEBUG_FA_ENTRY_EXTENSION_CMD または DEBUG_FA_ENTRY_ANSI_STRINGかどうかを確認します。 タグに関連付けられているデータ型にこれら 2 つの値のいずれかが含まれていない場合、このメソッドは null 返し、エントリのデータ ブロックを上書きしません。
このメソッドは、指定したタグで FA エントリが見つからない場合は、そのタグを使用して新しい FA エントリを作成し、タグをデータ型 DEBUG_FA_ENTRY_EXTENSION_CMDに関連付けます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | extsfns.h |
関連項目
AddExtensionCommand の