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

Artigo
02/06/2025

O método SetValues2 define o valor de vários dos registros de do destino.

Sintaxe

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           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 para os quais definir os valores.

[in, optional] Indices

Especifica uma matriz que contém os índices dos registros para os quais definir 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 definidos consecutivamente a partir desse índice. Caso contrário, ele será ignorado.

[in] Values

Uma matriz que contém os valores aos quais definir os 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.

Observações

O mecanismo faz o possível para converter os valores em valores no tipo dos registros; essa conversão é a mesma executada pelo CoerceValue. Se o valor for maior do que o que o registro pode conter, os bits menos significativos serão descartados. As conversões de ponto flutuante e inteiro também serão executadas, se necessário.

Se o valor retornado não for S_OK, alguns dos registros ainda poderão ter sido definidos.

Quando um subregistro é alterado, o registro que o contém também é alterado.

O método SetValues 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

IDebugRegisters2

SetValue

setValues

Compartilhar via