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 |
---|---|
|
Método realizado correctamente. |
|
No se puede acceder al destino o no se pudo tener acceso 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. |
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) |