IDebugFailureAnalysis::GetString メソッド (extsfns.h)

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

GetString メソッドは、指定されたタグを持つ最初の FA エントリを DebugFailureAnalysis オブジェクトで検索します。指定したタグを持つ FA エントリが見つかると、エントリのデータブロックから ANSI 文字列値が取得されます。

構文

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

パラメーター

[in] Tag

FA_TAG列挙の値。

[out] Str

エントリのデータブロックから文字列値を受け取るバッファーへのポインター。

[in] MaxSize

Str が指すバッファーのサイズ (バイト単位)。

戻り値

このメソッドは、指定されたタグを持つ FA エントリを検索し、データブロックの取得に成功した場合は、 FA_ENTRY 構造体へのポインターを返します。それ以外の場合は NULL を返します。

注釈

このメソッドは、エントリのデータブロックから Str が指すバッファーに null で終わる文字列をコピーします。このメソッドは、NULL ターミネータを含む 最大 MaxSize 文字をコピーします。

DebugFailureAnalysis オブジェクトで既に使用されている各タグは、FA_ENTRY_TYPE列挙のデータ型のいずれかに関連付けられています。タグに関連付けられているデータ型を確認するには、IDebugFAEntryTags インターフェイスの GetType メソッドを呼び出します。 IDebugFAEntryTags インターフェイスへのポインターを取得するには、IDebugFailureAnalysis2 インターフェイスの GetDebugFATagControl メソッドを呼び出します。

このメソッドを適切に使用するには、データ型が DEBUG_FA_ENTRY_ANSI_STRING の FA エントリからデータブロックを取得します。