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

AddString メソッドは、新しい FA エントリを DebugFailureAnalysis オブジェクトに追加し、FA エントリのデータブロックを指定した文字列に設定します。

構文

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

Tag

FA_TAG 列挙体の値。このタグに関連付けられているデータ型は DEBUG_FA_ENTRY_ANSI_STRINGする必要があります。

[in] Str

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

このメソッドが成功した場合は、新しい FA_ENTRY 構造体へのポインターを返します。このメソッドが失敗した場合は、NULLを返します。

このメソッドは、新しい FA_ENTRY 構造体の DataSize メンバーを、NULL ターミネータを含む文字列の長さ (バイト単位) に設定します。

各タグは、FA_ENTRY_TYPE 列挙型のいずれかのデータ型に関連付けられます。タグに関連付けられているデータ型を確認するには、IDebugFAEntryTags インターフェイスの GetType メソッドを呼び出します。

IDebugFAEntryTags インターフェイスへのポインターを取得するには、IDebugFailureAnalysis2 インターフェイスの GetDebugFATagControl メソッドを呼び出します。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	extsfns.h