Compartilhar via

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

  • Artigo

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

Sintaxe

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

Parâmetros

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

[in] Values

Especifica a matriz que contém 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.
E_UNEXPECTED
 O destino não está acessível ou um ou mais dos registros não puderam ser acessados.
E_INVALIDARG
 O valor do índice de um ou mais registros é maior do que o número de registros no computador de destino.

Comentários

O mecanismo faz o possível para coagir os valores em Valores para o tipo de registros; essa coerçã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.

Para definir o valor de apenas um único registro, use o método SetValue .

O método SetValues2 executa a mesma tarefa que esse método, mas também permite que a fonte de registro seja especificada.

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

IDebugRegisters

IDebugRegisters2

SetValue

SetValues2