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

[アーティクル]
08/07/2023

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

構文

PFA_ENTRY SetUlong(
       FA_TAG Tag,
  [in] ULONG  Value
);

パラメーター

Tag

FA_TAG列挙の値。

[in] Value

新規または既存の FA 項目のデータ・ブロックに書き込む ULONG 値。

戻り値

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

注釈

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

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