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

Artigo
02/23/2024

O método GetValues obtém o valor de vários dos registros do destino.

Sintaxe

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

Parâmetros

[in] Count

Especifica o número de registros cujos valores são solicitados.

[in, optional] Indices

Especifica uma matriz que contém os índices dos registros dos quais obter os valores. O número de elementos nesta matriz é Count. Se Indices for NULL, Start será usado em vez disso.

[in] Start

Se Indices for NULL, os registros serão lidos consecutivamente a partir desse índice. Caso contrário, ele será ignorado.

[out] Values

Recebe os valores dos registros. O número de elementos que essa matriz contém é Count. Consulte DEBUG_VALUE para obter uma descrição desse tipo de parâmetro.

Retornar valor

Essa lista não contém todos os erros que podem ocorrer. Para obter uma lista de possíveis erros, consulte Valores HRESULT.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_UNEXPECTED	O destino não está acessível ou um dos registros não pôde ser acessado.
E_INVALIDARG	O valor do índice de um dos registros é maior que o número de registros no computador de destino. Os resultados parciais podem ter sido obtidos; os registros que não puderam ser lidos terão o tipo DEBUG_VALUE_INVALID.

Comentários

GetValues obtém o valor de vários dos registros do destino.

Se o valor retornado não for S_OK, alguns dos registros ainda poderão ter sido lidos. Se o destino não estiver acessível, o tipo de retorno será E_UNEXPECTED e Valores permanecerão inalterados ; caso contrário, Valores conterão resultados parciais e os registros que não puderam ser lidos terão o tipo DEBUG_VALUE_INVALID. A ambiguidade no caso do valor retornado E_UNEXPECTED pode ser evitada definindo a memória de Valores como zero antes de chamar esse método.

Para receber o valor de apenas um único registro, use o método GetValue .

O método GetValues2 executa a mesma tarefa que esse método, mas também permite que a origem do registro seja especificada.

Para obter uma visão geral da interface IDebugRegisters e outros métodos relacionados ao registro, consulte Registros.