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

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

SetString メソッドは、指定されたタグを持つ最初の FA エントリを DebugFailureAnalysis オブジェクトで検索します。指定したタグを持つ FA エントリが見つかると、FA エントリのデータブロックが指定された文字列値に設定 (上書き) されます。このメソッドは、指定したタグを持つ FA エントリが見つからない場合は、そのタグを持つ新しい FA エントリを作成し、指定した文字列値に新しい FA エントリのデータブロックを設定します。

構文

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

パラメーター

Tag

FA_TAG列挙の値。

[in] Str

新規または既存の FA エントリのデータブロックに書き込まれる null で終わる ANSI 文字列へのポインター。

戻り値

このメソッドが成功すると、新規または既存の FA_ENTRY 構造体へのポインターが返されます。それ以外の場合は NULL を返します。

注釈

このメソッドは、指定したタグを持つ FA エントリを検索した場合、そのタグに関連付けられているデータ型が DEBUG_FA_ENTRY_ANSI_STRING か DEBUG_FA_ENTRY_EXTENSION_CMDかを確認します。タグに関連付けられているデータ型がこれら 2 つの型の 1 つでない場合、このメソッドは NULL を 返し、エントリのデータブロックを上書きしません。

このメソッドは、指定したタグを持つ FA エントリが見つからない場合は、そのタグを使用して新しい FA エントリを作成し、タグをデータ型 DEBUG_FA_ENTRY_ANSI_STRINGに関連付けます。