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