Funzione SymFromName (dbghelp.h)

Recupera le informazioni sui simboli per il nome specificato.

Sintassi

BOOL IMAGEAPI SymFromName(
  [in]      HANDLE       hProcess,
  [in]      PCSTR        Name,
  [in, out] PSYMBOL_INFO Symbol
);

Parametri

[in] hProcess

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

[in] Name

Nome del simbolo da individuare.

[in, out] Symbol

Puntatore a una struttura SYMBOL_INFO che fornisce informazioni sul simbolo.

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 al nome.

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