Metodo IDebugRegisters::SetValues (dbgeng.h)

Articolo
02/23/2024

Il metodo SetValues imposta il valore di diversi registri della destinazione.

Sintassi

HRESULT SetValues(
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

Parametri

[in] Count

Specifica il numero di registri per cui impostare i valori.

[in, optional] Indices

Specifica una matrice che contiene gli indici dei registri per cui impostare i valori. Il numero di elementi in questa matrice è Count. Se Indices è NULL, viene invece usato Start.

[in] Start

Se Indices è NULL, i registri verranno impostati consecutivamente a partire da questo indice. In caso contrario, viene ignorato.

[in] Values

Specifica la matrice che contiene i valori a cui impostare i registri. Il numero di elementi contenuti in questa matrice è Count. 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 a uno o più registri.
E_INVALIDARG	Il valore dell'indice di uno o più registri è maggiore del numero di registri nel computer di destinazione.

Commenti

Il motore fa del suo meglio per coercire i valori in Valori nel tipo dei registri; 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.

Se il valore restituito non è S_OK, è possibile che alcuni registri siano ancora stati impostati.

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

Per impostare il valore di un solo registro, utilizzare invece il metodo SetValue .

Il metodo SetValues2 esegue la stessa attività di questo metodo, ma consente anche di specificare l'origine del registro.

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.