Compartir a través de

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

  • Artículo

El método GetValues2 captura el valor de varios de los registros del destino.

Sintaxis

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

Parámetros

[in] Source

Especifica el origen de registro que se va a consultar.

Los valores posibles se enumeran en la tabla siguiente.

Valor Registro del origen
DEBUG_REGSRC_DEBUGGEE Captura de información de registro del destino.
DEBUG_REGSRC_EXPLICIT Capturar información de registro del contexto de registro explícito actual.
DEBUG_REGSRC_FRAME Capturar información de registro del contexto de registro del ámbito actual.
Nota El desenredado de pila no garantiza una actualización precisa del contexto de registro, por lo que es posible que el contexto de registro del marco de ámbito no sea preciso en todos los casos.
 

[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_INVALIDARG
 El valor del índice de uno de los registros es mayor que el número de registros en el equipo 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

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 se 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.

El método GetValues realiza la misma tarea que este método, pero siempre usa el destino como 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)

Consulte también

GetValue

GetValues

IDebugRegisters2