Funzione SymFromAddr (dbghelp.h)

Recupera le informazioni sui simboli per l'indirizzo specificato.

Sintassi

BOOL IMAGEAPI SymFromAddr(
  [in]            HANDLE       hProcess,
  [in]            DWORD64      Address,
  [out, optional] PDWORD64     Displacement,
  [in, out]       PSYMBOL_INFO Symbol
);

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in] Address

Indirizzo per il quale deve essere individuato un simbolo. L'indirizzo non deve trovarsi sul limite di un simbolo. Se l'indirizzo viene dopo l'inizio di un simbolo e prima della fine del simbolo, viene trovato il simbolo.

[out, optional] Displacement

Spostamento dall'inizio del simbolo o zero.

[in, out] Symbol

Puntatore a una struttura SYMBOL_INFO che fornisce informazioni sul simbolo. Il nome del simbolo è di lunghezza variabile; pertanto questo buffer deve essere sufficientemente grande da contenere il nome archiviato alla fine della struttura SYMBOL_INFO . Assicurarsi di impostare il membro MaxNameLen sul numero di byte riservati per il nome.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Esempio

Per un esempio, vedere Recupero delle informazioni sui simboli in base all'indirizzo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 5.1 o versione successiva

Vedi anche

Funzioni DbgHelp

SYMBOL_INFO