IDebugRegisters2::SetValue メソッド (dbgeng.h)
SetValue メソッドは、ターゲットのレジスタの 1 つの値を設定します。
構文
HRESULT SetValue(
[in] ULONG Register,
[in] PDEBUG_VALUE Value
);
パラメーター
[in] Register
値を設定するレジスタのインデックスを指定します。
[in] Value
レジスタを設定する値を指定します。 このパラメーター型の説明については、「 DEBUG_VALUE 」を参照してください。
戻り値
この一覧には、発生する可能性のあるすべてのエラーが含まれていません。 考えられるエラーの一覧については、「 HRESULT 値」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
ターゲットにアクセスできないか、レジスタにアクセスできませんでした。 |
|
Register の値がターゲット コンピューター上のレジスタの数より大きい。 |
注釈
エンジンは、 Value の値をレジスタの型に強制するために最善を尽くします。この強制は、 CoerceValue によって実行されるのと同じです。 値がレジスタが保持できる値より大きい場合、最下位ビットは削除されます。 必要に応じて、浮動小数点変換と整数変換も実行されます。
サブ登録が変更されると、それを含むレジスタも変更されます。
複数のレジスタの値を設定するには、代わりに SetValues メソッドを 使用します。
IDebugRegisters インターフェイスとその他のレジスタ関連のメソッドの概要については、「Registers」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | dbgeng.h (DbgEng.h を含む) |