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

Статья
02/23/2024

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

Если аргумент Indexs имеет значение NULL, регистры будут задаваться последовательно, начиная с этого индекса. В противном случае он игнорируется.

[in] Values

Указывает массив, содержащий значения, для которых необходимо задать регистры. Число элементов, удерживаемых в этом массиве, равно Числу. Описание этого типа параметра см. в DEBUG_VALUE .

Возвращаемое значение

Этот список не содержит всех ошибок, которые могут возникнуть. Список возможных ошибок см. в разделе Значения HRESULT.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_UNEXPECTED	Целевой объект недоступен, или не удалось получить доступ к одному или нескольким регистрам.
E_INVALIDARG	Значение индекса одного или нескольких регистров больше числа регистров на целевом компьютере.

Подсистема делает все возможное, чтобы принудить значения из значений в значениях к типу регистров; это приведение совпадает с методом CoerceValue. Если значение больше того, что может содержать регистр, то удаляются наименьшие значимые биты. При необходимости также будут выполняться преобразования с плавающей запятой и целыми числами.

Если возвращаемое значение не S_OK, возможно, были заданы некоторые регистры.

При изменении подрегистрастра также изменяется регистр, содержащий его.

Чтобы задать значение только одного регистра, используйте метод SetValue .

Метод SetValues2 выполняет ту же задачу, что и этот метод, но также позволяет указать источник регистра.

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