Método IDebugRegisters::GetValues (dbgeng.h)
El método GetValues obtiene el valor de varios de los registros del destino.
Sintaxis
HRESULT GetValues(
[in] ULONG Count,
[in, optional] PULONG Indices,
[in] ULONG Start,
[out] PDEBUG_VALUE Values
);
Parámetros
[in] Count
Especifica el número de registros cuyos valores se solicitan.
[in, optional] Indices
Especifica una matriz que contiene los índices de los registros de los que se van a obtener 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 Índices es NULL, los registros se leerán de forma consecutiva a partir de este índice. De lo contrario, se omite.
[out] Values
Recibe los valores de 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 acceder a uno de los registros. |
|
El valor del índice de uno de los registros es mayor que el número de registros en la máquina de destino. Es posible que se hayan obtenido resultados parciales; esos registros que no se pudieron leer tendrán el tipo DEBUG_VALUE_INVALID. |
Comentarios
GetValues obtiene el valor de varios de los registros del destino.
Si el valor devuelto no es S_OK, es posible que se hayan leído algunos de los registros. Si el destino no era accesible, el tipo de valor devuelto es E_UNEXPECTED y Los valores no se modifican; De lo contrario, los valores contendrán resultados parciales y los registros que no se pudieron leer tendrán el tipo DEBUG_VALUE_INVALID. La ambigüedad en el caso del valor devuelto E_UNEXPECTED se puede evitar estableciendo la memoria de Valores en cero antes de llamar a este método.
Para recibir el valor de solo un registro, use el método GetValue en su lugar.
El método GetValues2 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 (incluir DbgEng.h) |