Condividi tramite


Funzione SymEnumSymbolsForAddrW (dbghelp.h)

Enumera i simboli per l'indirizzo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per 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 su un limite di simboli. 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 presente 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 non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione genereranno probabilmente 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.

Nota

L'intestazione dbghelp.h definisce SymEnumSymbolsForAddr come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione dbghelp.h
libreria Dbghelp.lib
dll Dbghelp.dll
Ridistribuibile DbgHelp.dll 6.0 o versione successiva

Vedere anche

DbgHelp Functions

SymEnumSymbolsProc