共用方式為

(dbgeng.h) IDebugRegisters2：：SetValues2 方法

  • 發行項

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

語法

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

參數

[in] Source

指定要查詢的緩存器來源。

下表列出可能的值。

值 註冊來源
DEBUG_REGSRC_DEBUGGEE 從目標擷取註冊資訊。
DEBUG_REGSRC_EXPLICIT 從目前的明確 緩存器內容擷取緩存器資訊。
DEBUG_REGSRC_FRAME 從目前範圍的緩存器內容擷取緩存器資訊。
注意 堆疊回溯並不保證正確更新緩存器內容，因此範圍框架的緩存器內容在所有情況下可能都不正確。
 

[in] Count

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

[in, optional] Indices

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

[in] Start

如果 索引 為 NULL，則會從這個索引開始連續設定緩存器。 否則會予以忽略。

[in] Values

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

傳回值

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

傳回碼 描述
S_OK
 此方法成功。

備註

引擎會盡最大努力將 Values 中的值轉換成緩存器的類型;此轉換與 CoerceValue 所執行的轉換相同。 如果值大於緩存器可以保留的值，則會捨棄最小有效位。 如有必要，也會執行浮點和整數轉換。

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

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

SetValues 方法會執行與此方法相同的工作，但一律會使用目標作為緩存器來源。

如需 IDebugRegisters 介面和其他緩存器相關方法的概觀，請參閱 Registers。

規格需求

需求 值
目標平台 桌面
標頭 dbgeng.h (包含 DbgEng.h)

另請參閱

IDebugRegisters2

SetValue

SetValues