Метод IDebugRegisters2::SetValue (dbgeng.h)

Статья
08/07/2023

Метод 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.