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

Artículo
02/23/2024

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
S_OK	Método realizado correctamente.
E_UNEXPECTED	No se puede acceder al destino o no se pudo acceder a uno de los registros.
E_INVALIDARG	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.