Compartir a través de


Método IDebugRegisters2::SetValues (dbgeng.h)

El método SetValues establece el valor de varios de los registros del destino.

Sintaxis

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

Parámetros

[in] Count

Especifica el número de registros para los que se van a establecer los valores.

[in, optional] Indices

Especifica una matriz que contiene los índices de los registros para los que se van a establecer los valores. El número de elementos de esta matriz es Count. Si Indexs es NULL, se usa Start en su lugar.

[in] Start

Si Los índices son NULL, los registros se establecerán consecutivamente a partir de este índice. De lo contrario, se omite.

[in] Values

Especifica la matriz que contiene valores a los que se van a establecer los registros. El número de elementos que contiene esta matriz es Count. Consulte DEBUG_VALUE para obtener una descripción de este tipo de parámetro.

Valor devuelto

Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte Valores HRESULT.

Código devuelto Descripción
S_OK
Método realizado correctamente.
E_UNEXPECTED
No se puede acceder al destino o no se pudo tener acceso a uno o varios de los registros.
E_INVALIDARG
El valor del índice de uno o varios de los registros es mayor que el número de registros en la máquina de destino.

Comentarios

El motor hace lo mejor para coertar los valores de Valores en el tipo de los registros; esta coerción es la misma que la realizada por CoerceValue. Si el valor es mayor que lo que puede contener el registro, se quitan los bits menos significativos. Las conversiones de enteros y de punto flotante también se realizarán si es necesario.

Si el valor devuelto no es S_OK, es posible que algunos de los registros todavía se hayan establecido.

Cuando se modifica un subregistro, también se modifica el registro que lo contiene.

Para establecer el valor de solo un registro, use el método SetValue en su lugar.

El método SetValues2 realiza la misma tarea que este método, pero también permite especificar el origen del registro.

Para obtener información general sobre la interfaz IDebugRegisters y otros métodos relacionados con el registro, consulte Registros.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include DbgEng.h)

Consulte también

IDebugRegisters

IDebugRegisters2

SetValue

SetValues2