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

Artigo
02/06/2025

O método GetValues2 busca o valor de vários dos registros de 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. Observação 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 nessa matriz é Contagem. Se índices estiver NULL, iniciar será usado.

[in] Start

Se Índices 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 é Contagem. Consulte DEBUG_VALUE para obter uma descrição desse tipo de parâmetro.

Valor de retorno

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 do que o número de registros no computador de destino. Resultados parciais podem ter sido obtidos; os registros que não puderam ser lidos terão o tipo DEBUG_VALUE_INVALID.

Observações

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 ficará inalterado. Caso contrário, valores conterá 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 como a origem do registro.

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua DbgEng.h)

Consulte também

GetValue

GetValues

IDebugRegisters2

Compartilhar via