SetString メソッドは、DebugFailureAnalysis オブジェクトで、指定したタグを持つ最初の FA エントリ を検索します。 指定したタグを持つ 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に関連付けます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | extsfns.h |
関連項目
AddString の