Metodo IDebugRegisters2::GetPseudoDescriptionWide (dbgeng.h)

Articolo
02/23/2024

Il metodo GetPseudoDescriptionWide restituisce una descrizione di un pseudoregistro, incluso il nome e il tipo.

Sintassi

HRESULT GetPseudoDescriptionWide(
  [in]            ULONG    Register,
  [out, optional] PWSTR    NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

Parametri

[in] Register

Specifica l'indice dello pseudoregistro la cui descrizione viene richiesta. L'indice è sempre compreso tra zero e il numero di pseudoregistri (restituiti da GetNumberPseudoRegisters) meno uno.

[out, optional] NameBuffer

Riceve il nome dello pseudoregistro. Se NameBuffer è NULL, queste informazioni non vengono restituite.

[in] NameBufferSize

Specifica le dimensioni, in caratteri, del buffer specificato da NameBuffer . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Riceve le dimensioni in caratteri del nome dello pseudoregistro. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è NULL, queste informazioni non vengono restituite.

[out, optional] TypeModule

Riceve l'indirizzo di base del modulo a cui appartiene il tipo di registro. Se il tipo del registro non è noto, viene restituito zero. Se TypeModule è NULL, non vengono restituite informazioni.

[out, optional] TypeId

Riceve l'ID di tipo del tipo all'interno del modulo restituito in TypeModule. Se l'ID del tipo non è noto, viene restituito zero. Se TypeId è NULL, non vengono restituite informazioni.

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_FAIL	La descrizione per il registro non è disponibile

Commenti

Le descrizioni non sono sempre disponibili per tutti i registri. Se un pseudoregistro non ha un valore, ad esempio $eventip non avrà un valore prima che si sia verificato un evento oppure non è possibile determinare un tipo per uno pseudoregistro, questo metodo restituirà E_FAIL.

Per una panoramica dell'interfaccia IDebugRegisters e di altri metodi correlati al registro, vedere Registri.