IDebugFailureAnalysis2::SetExtensionCommand メソッド (extsfns.h)

[アーティクル]
02/26/2024

SetExtensionCommand メソッドは、指定したタグを持つ最初の FA エントリについて DebugFailureAnalysis オブジェクトを検索します。指定したタグを持つ 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に関連付けます。