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 |