IDebugRegisters2::SetValue メソッド (dbgeng.h)

SetValue メソッドは、ターゲットのレジスタの 1 つの値を設定します。

構文

HRESULT SetValue(
  [in] ULONG        Register,
  [in] PDEBUG_VALUE Value
);

[in] Register

値を設定するレジスタのインデックスを指定します。

[in] Value

レジスタを設定する値を指定します。このパラメーター型の説明については、DEBUG_VALUE を参照してください。

この一覧には、発生する可能性のあるすべてのエラーが含まれているわけではありません。発生する可能性のあるエラーの一覧については、「HRESULT 値を参照してください。

リターンコード	形容
S_OK	メソッドが成功しました。
E_UNEXPECTED	ターゲットにアクセスできないか、レジスタにアクセスできませんでした。
E_INVALIDARG	Register の値が、ターゲットコンピューター上のレジスタの数を超える。

エンジンは、Value の値をレジスタの型に強制するために最善を尽くします。この強制は、 CoerceValueによって実行されるのと同じです。値がレジスタが保持できる値より大きい場合、下位ビットは削除されます。必要に応じて、浮動小数点変換と整数変換も実行されます。

サブ登録が変更されると、それを含むレジスタも変更されます。

複数のレジスタの値を設定するには、代わりに SetValues メソッドを使用します。

IDebugRegisters インターフェイスおよびその他のレジスタ関連メソッドの概要については、「Registers」を参照してください。

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (DbgEng.h を含む)