Metodo IDebugRegisters2::GetPseudoDescription (dbgeng.h)

2025-02-06

Il metodo GetPseudoDescription restituisce una descrizione di uno pseudoregistro, incluso il nome e il tipo.

Sintassi

HRESULT GetPseudoDescription(
  [in]            ULONG    Register,
  [out, optional] PSTR     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 è 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 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 del registro. Se il tipo del registro non è noto, viene restituito zero. Se TypeModule è NULL, non vengono restituite informazioni.

[out, optional] TypeId

Riceve l'ID 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 dei possibili errori, vedere valori HRESULT.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
E_FAIL	La descrizione per il registro non era disponibile

Osservazioni

Le descrizioni non sono sempre disponibili per tutti i registri. Se uno 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 di IDebugRegisters di e di altri metodi correlati al registro, vedere Registers.