Compartir a través de


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

El método SetValue establece el valor de uno de los registros del destino.

Sintaxis

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

Parámetros

[in] Register

Especifica el índice del registro cuyo valor se va a establecer.

[in] Value

Especifica el valor al que se va a establecer el registro. Consulte DEBUG_VALUE para obtener una descripción de este tipo de parámetro.

Valor devuelto

Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte Valores HRESULT.

Código devuelto Descripción
S_OK
Método realizado correctamente.
E_UNEXPECTED
No se puede acceder al destino o no se pudo acceder al registro.
E_INVALIDARG
El valor de Register es mayor que el número de registros en la máquina de destino.

Comentarios

El motor hace lo mejor para coercer el valor de Value en el tipo del registro; esta coerción es la misma que la realizada por CoerceValue. Si el valor es mayor que lo que puede contener el registro, se quitan los bits menos significativos. Las conversiones de enteros y de punto flotante también se realizarán si es necesario.

Cuando se modifica un subregistro, también se modifica el registro que lo contiene.

Para establecer los valores de varios registros, use el método SetValues en su lugar.

Para obtener información general sobre la interfaz IDebugRegisters y otros métodos relacionados con el registro, consulte Registros.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include DbgEng.h)

Consulte también

IDebugRegisters

IDebugRegisters2

SetValues

SetValues2