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

  • Artigo

O método SetValues2 define o valor de vários dos registros 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 Busque 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 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 é Count. Se Índices for NULL, Iniciar será usado.

[in] Start

Se Índices for NULL, os registros serão definidos consecutivamente a partir desse índice. Caso contrário, será ignorada.

[in] Values

Uma matriz que contém os valores para os quais os registros devem ser definidos. 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.

Comentários

O mecanismo faz o melhor para converter os valores em Valores no tipo dos registros; essa conversão é a mesma executada por CoerceValue. Se o valor for maior do que o que o registro pode conter, os bits menos significativos serão descartados. 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 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

IDebugRegisters2

SetValue

SetValues