Metodo IDebugRegisters2::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 i quali 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 gli indici sono NULL, viene invece usato Start.

[in] Start

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

[in] Values

Specifica la matrice che contiene valori a cui impostare i registri. Il numero di elementi che questa matrice contiene è 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 degli errori possibili, 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 esegue al meglio la coercizione dei valori in Valori nel tipo dei registri; 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. Le conversioni a virgola mobile e intere verranno eseguite anche se necessario.

Se il valore restituito non è S_OK, alcuni dei registri potrebbero essere ancora stati impostati.

Quando viene modificata una sottoregister, viene modificato anche il registro contenente.

Per impostare il valore di un solo registro, usare 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 Registri.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include DbgEng.h)

Vedi anche