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

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

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

構文

PFA_ENTRY GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

パラメーター

[in] Tag

FA_TAG列挙の値。

[out] Value

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

戻り値

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

注釈

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

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

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