Metodo IDebugRegisters2::GetValues (dbgeng.h)

Articolo
02/06/2025

Il metodo GetValues ottiene il valore di diversi registri di destinazione.

Sintassi

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

Parametri

[in] Count

Specifica il numero di registri i cui valori sono richiesti.

[in, optional] Indices

Specifica una matrice che contiene gli indici dei registri da cui ottenere i valori. Il numero di elementi in questa matrice è Count. Se indici è NULL, viene invece utilizzato Start.

[in] Start

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

[out] Values

Riceve i valori dei 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 dei registri.
E_INVALIDARG	Il valore dell'indice di uno dei registri è maggiore del numero di registri nel computer di destinazione. Potrebbero essere stati ottenuti risultati parziali; i registri che non possono essere letti avranno il tipo DEBUG_VALUE_INVALID.

Osservazioni

getValues ottiene il valore di diversi registri della destinazione.

Se il valore restituito non è S_OK, alcuni registri potrebbero essere ancora stati letti. Se la destinazione non è accessibile, il tipo restituito è E_UNEXPECTED e i valori non sono modificati; in caso contrario, Valori conterrà risultati parziali e i registri che non è stato possibile leggere avranno tipo DEBUG_VALUE_INVALID. È possibile evitare ambiguità nel caso del valore restituito E_UNEXPECTED impostando la memoria di Valori su zero prima di chiamare questo metodo.

Per ricevere il valore di un solo registro, usare invece il metodo GetValue.

Il metodo GetValues2 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.