Metodo IDebugRegisters2::SetValue (dbgeng.h)

Articolo
02/06/2025

Il metodo SetValue imposta il valore di uno dei registri di 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 ha avuto esito positivo.
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.

Osservazioni

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

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

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

Per una panoramica dell'interfaccia di IDebugRegisters di e di altri metodi correlati al registro, vedere Registers.