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 值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
無法存取目標,或無法存取一或多個緩存器。 |
|
一或多個緩存器之索引的值大於目標計算機上的緩存器數目。 |
言論
引擎會盡最大努力將 Values 中的值強制 到緩存器的類型;這個強制設定與 CoerceValue所執行的相同。 如果值大於緩存器可以保留的值,則會卸除最小有效位。 如有必要,也會執行浮點和整數轉換。
如果傳回值未S_OK,部分緩存器可能仍可能已設定。
變更子登錄時,也會改變包含它的緩存器。
若要只設定單一緩存器的值,請改用 SetValue 方法。
setValues2 方法 執行與此方法相同的工作,但也允許指定緩存器來源。
如需 IDebugRegisters 介面和其他註冊相關方法的概觀,請參閱 Registers。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include DbgEng.h) |