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

Общие сведения о интерфейсе IDebugRegisters и других методах, связанных с регистрами, см. в разделе Registers.

Требования

Требование Ценность
целевая платформа Настольный
заголовка dbgeng.h (include DbgEng.h)

См. также

IDebugRegisters

IDebugRegisters2

SetValues

SetValues2

  • Last updated on