Funzione SymGetSymbolFile (dbghelp.h)

Articolo
08/23/2023

Individua un file di simboli nel percorso del simbolo specificato.

Sintassi

BOOL IMAGEAPI SymGetSymbolFile(
  [in, optional] HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  ImageFile,
  [in]           DWORD  Type,
  [out]          PSTR   SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PSTR   DbgFile,
  [in]           size_t cDbgFile
);

Parametri

[in, optional] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

Se questo handle è 0, SymPath non può essere NULL. Usare questa opzione per caricare un file di simboli senza chiamare SymInitialize o SymCleanup.

[in, optional] SymPath

Percorso del simbolo. Se questo parametro è NULL o una stringa vuota, la funzione usa il percorso del simbolo impostato usando la funzione SymInitialize o SymSetSearchPath .

[in] ImageFile

Nome del file di immagine.

[in] Type

Tipo di file di simboli. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
sfImage 0	File .exe o .dll.
sfDbg 1	File con estensione dbg.
sfPdb 2	File con estensione pdb.
sfMpd 3	Riservato.

[out] SymbolFile

Puntatore a una stringa con terminazione null che riceve il nome del file di simboli.

[in] cSymbolFile

Dimensioni del buffer SymbolFile , in caratteri.

[out] DbgFile

Puntatore a un buffer che riceve il percorso completo del file di simboli. Questo buffer deve essere almeno MAX_PATH caratteri.

[in] cDbgFile

Dimensioni del buffer DbgFile , in caratteri.

Valore restituito

Se il server individua un file di simboli valido, restituisce TRUE; in caso contrario, restituisce FALSE e GetLastError restituisce un valore che indica perché il file di simboli non è stato restituito.

Commenti

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


Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 6.3 o versioni successive

Vedi anche

Funzioni DbgHelp

SymInitialize

Condividi tramite