Método IDebugRegisters2::SetValue (dbgeng.h)
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.
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 |
|---|---|
|
O método foi bem-sucedido. |
|
O destino não está acessível ou o registro não pôde ser acessado. |
|
O valor de Registrar é maior do que o número de registros no computador de destino. |
Observações
O mecanismo faz o possível 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. As 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 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) |