Metodo IDebugRegisters2::SetValue (dbgeng.h)

Articolo
02/25/2024

Il metodo SetValue imposta il valore di uno dei registri della destinazione.

Sintassi

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

Parametri

[in] Register

Specifica l'indice del registro il cui valore deve essere impostato.

[in] Value

Specifica il valore a cui impostare il registro. Per una descrizione di questo tipo di parametro , vedere DEBUG_VALUE .

Valore restituito

Questo elenco non contiene tutti gli errori che potrebbero verificarsi. Per un elenco dei possibili errori, vedere Valori HRESULT.

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_UNEXPECTED	La destinazione non è accessibile o non è possibile accedere al registro.
E_INVALIDARG	Il valore di Register è maggiore del numero di registri nel computer di destinazione.

Commenti

Il motore fa del suo meglio per coercire il valore di Value nel tipo del registro; questa coercizione è uguale a quella eseguita da CoerceValue. Se il valore è maggiore di quello che può contenere il registro, vengono eliminati i bit meno significativi. Le conversioni a virgola mobile e integer verranno eseguite anche se necessario.

Quando viene modificata una sottoregister, viene modificato anche il registro che lo contiene.

Per impostare i valori di più registri, utilizzare invece il metodo SetValues .

Per una panoramica dell'interfaccia IDebugRegisters e di altri metodi correlati al registro, vedere Registers.For an overview of the IDebugRegisters interface and other register-related methods, see Registers.