IDebugRegisters2::SetValue 方法 (dbgeng.h)

SetValue 方法设置目标寄存器之一的值。

语法

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)

另请参阅

IDebugRegisters

IDebugRegisters2

SetValues

SetValues2