Metodo IDebugRegisters2::SetValues (dbgeng.h)

2025-02-06

Il metodo SetValues imposta il valore di diversi registri di 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 indici è NULL, viene invece utilizzato Start.

[in] Start

Se indice è 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 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 ha avuto esito positivo.
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.

Osservazioni

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. Anche le conversioni a virgola mobile e integer verranno eseguite se necessario.

Se il valore restituito non è S_OK, alcuni registri potrebbero essere 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 di IDebugRegisters di e di altri metodi correlati al registro, vedere Registers.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include DbgEng.h)

Vedere anche