Método IDebugRegisters2::SetValues (dbgeng.h)
El método SetValues establece el valor de varios de los registros de de 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 índices es NULL, se usa start en su lugar.
[in] Start
Si índices es 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 |
|---|---|
|
El método se realizó correctamente. |
|
No se puede acceder al destino o no se pudo acceder a uno o varios de los registros. |
|
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. |
Observaciones
El motor hace lo mejor para coertar los valores de Valores en el tipo de registros; esta coerción es la misma que la realizada por CoerceValue. Si el valor es mayor que el registro puede contener, 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 se hayan establecido algunos de los registros.
Cuando se modifica un registrador, el registro que lo contiene también se modifica.
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 de IDebugRegisters y otros métodos relacionados con el registro, consulte Registers.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include DbgEng.h) |