IDebugFailureAnalysis2::SetUlong64 メソッド (extsfns.h)
SetUlong64 メソッドは、DebugFailureAnalysis オブジェクトで、指定したタグを持つ最初の FA エントリ を検索します。 指定したタグを持つ FA 項目が見つかると、FA 項目のデータ・ブロックが指定された ULONG64 値に設定 (上書き) されます。 このメソッドは、指定したタグを持つ FA エントリ を見つけられない場合は、そのタグを持つ新しい FA エントリを作成し、新しい FA エントリのデータ ブロックを指定した ULONG64 値に設定します。
構文
PFA_ENTRY SetUlong64(
FA_TAG Tag,
[in] ULONG64 Value
);
パラメーター
Tag
FA_TAG 列挙体の値。
[in] Value
新規または既存の FA 項目のデータ・ブロックに書き込む ULONG64 値。
戻り値
このメソッドが成功すると、新規または既存の FA_ENTRY 構造体へのポインターが返されます。 それ以外の場合は、null 返します。
備考
このメソッドは、指定したタグを持つ FA エントリ を検索する場合は、そのタグに関連付けられているデータ型が DEBUG_FA_ENTRY_ULONG64、DEBUG_FA_ENTRY_INSTRUCTION_OFFSET、または DEBUG_FA_ENTRY_POINTERかどうかを確認します。 タグに関連付けられているデータ型にこれら 3 つの値のいずれかが含まれていない場合、このメソッドは NULL を返し、エントリのデータ ブロックを上書きしません。
このメソッドは、指定したタグで FA エントリが見つからない場合は、そのタグを持つ新しい FA エントリを作成し、タグをデータ型 DEBUG_FA_ENTRY_ULONG64に関連付けます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | extsfns.h |
関連項目
AddUlong64 を する