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

  • Artigo

O método GetValues2 busca o valor de vários dos registros do destino.

Sintaxe

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

Parâmetros

[in] Source

Especifica a origem do registro a ser consultada.

Os valores possíveis são listados na tabela a seguir.

Valor Registrar origem
DEBUG_REGSRC_DEBUGGEE Buscar informações de registro do destino.
DEBUG_REGSRC_EXPLICIT Buscar informações de registro do contexto de registro explícito atual.
DEBUG_REGSRC_FRAME Buscar informações de registro do contexto de registro do escopo atual.
Nota O desenrolamento de pilha não garante a atualização precisa do contexto de registro, portanto, o contexto de registro do quadro de escopo pode não ser preciso em todos os casos.
 

[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, será ignorada.

[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_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

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.

O método GetValues executa a mesma tarefa que esse método, mas sempre usa o destino que a origem do registro.

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua DbgEng.h)

Confira também

GetValue

GetValues

IDebugRegisters2