Funzione SymEnumSymbolsForAddr (dbghelp.h)

Enumera i simboli per l'indirizzo specificato.

Sintassi

BOOL IMAGEAPI SymEnumSymbolsForAddr(
  [in]           HANDLE                         hProcess,
  [in]           DWORD64                        Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                          UserContext
);

Parametri

[in] hProcess

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

[in] Address

Indirizzo per il quale si trovano i simboli. 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 (l'inizio del simbolo più la dimensione del simbolo), la funzione troverà il simbolo.

[in] EnumSymbolsCallback

Funzione di callback definita dall'applicazione. Questa funzione viene chiamata per ogni simbolo trovato in Address. Per altre informazioni, vedere SymEnumSymbolsProc.

[in, optional] UserContext

Dati facoltativi definiti dall'utente. Questo valore viene passato alla funzione di callback.

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.

Requisiti

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

Vedi anche

Funzioni DbgHelp

SymEnumSymbolsProc