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

Artigo
02/23/2024

O método SetValue define o valor de um dos registros do destino.

Sintaxe

HRESULT SetValue(
  [in] ULONG        Register,
  [in] PDEBUG_VALUE Value
);

Parâmetros

[in] Register

Especifica o índice do registro cujo valor deve ser definido.

[in] Value

Especifica o valor para o qual definir o registro. 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 o registro não pôde ser acessado.
E_INVALIDARG	O valor de Registrar é maior que o número de registros no computador de destino.

Comentários

O mecanismo faz o melhor para coagir o valor de Value para o tipo do registro; 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.

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

Para definir os valores de vários registros, use o método SetValues .

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