共用方式為


IDebugRegisters::SetValues 方法 (dbgeng.h)

SetValues 方法會設定目標 快取器的數個值。

語法

HRESULT SetValues(
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

參數

[in] Count

指定要設定值的緩存器數目。

[in, optional] Indices

指定數位,其中包含要為其設定值的緩存器索引。 此陣列中的元素數目 Count。 如果 索引NULL,則會改用 Start

[in] Start

如果 索引NULL,則會從這個索引開始連續設定緩存器。 否則會忽略它。

[in] Values

指定數位,其中包含要設定緩存器的值。 這個陣列保留的項目數目是 Count。 如需此參數類型的描述,請參閱 DEBUG_VALUE

傳回值

此清單不包含可能發生的所有錯誤。 如需可能的錯誤清單,請參閱 HRESULT 值

傳回碼 描述
S_OK
方法成功。
E_UNEXPECTED
無法存取目標,或無法存取一或多個緩存器。
E_INVALIDARG
一或多個緩存器之索引的值大於目標計算機上的緩存器數目。

言論

引擎會盡最大努力將 Values 中的值強制 到緩存器的類型;這個強制設定與 CoerceValue所執行的相同。 如果值大於緩存器可以保留的值,則會卸除最小有效位。 如有必要,也會執行浮點和整數轉換。

如果傳回值未S_OK,部分緩存器可能仍可能已設定。

變更子登錄時,也會改變包含它的緩存器。

若要只設定單一緩存器的值,請改用 SetValue 方法。

setValues2 方法 執行與此方法相同的工作,但也允許指定緩存器來源。

如需 IDebugRegisters 介面和其他註冊相關方法的概觀,請參閱 Registers

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h (include DbgEng.h)

另請參閱

IDebugRegisters

IDebugRegisters2

SetValue

SetValues2