Metodo IDebugRegisters2::GetValues (dbgeng.h)

Articolo
08/07/2023

Il metodo GetValues ottiene il valore di diversi registri della 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 gli indici sono NULL, viene invece usato 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 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 dei registri.
E_INVALIDARG	Il valore dell'indice di uno dei registri è maggiore del numero di registri nel computer di destinazione. I risultati parziali potrebbero essere stati ottenuti; tali registri che non possono essere letti avranno il tipo DEBUG_VALUE_INVALID.

Commenti

GetValues ottiene il valore di diversi registri della destinazione.

Se il valore restituito non è S_OK, alcuni dei registri potrebbero essere ancora stati letti. Se la destinazione non è accessibile, il tipo restituito è E_UNEXPECTED e i valori non vengono modificati; in caso contrario, i valori contengono risultati parziali e i registri che non possono essere letti avranno tipo DEBUG_VALUE_INVALID. L'ambiguità nel caso del valore restituito E_UNEXPECTED può essere evitata 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 IDebugRegisters e di altri metodi correlati al registro, vedere Registri.