Funzione FindDebugInfoFile (dbghelp.h)
Individua un file di debug (con estensione dbg).
Per fornire una funzione di callback per verificare il file di simboli che si trova, usare la funzione FindDebugInfoFileEx .
Sintassi
HANDLE IMAGEAPI FindDebugInfoFile(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath
);
Parametri
[in] FileName
Nome del file dbg desiderato. È possibile usare un percorso parziale.
[in] SymbolPath
Percorso in cui si trovano i file di simboli. Questo può essere più percorsi separati da punti e virgola. Per recuperare il percorso del simbolo, usare la funzione SymGetSearchPath .
[out] DebugFilePath
Puntatore a un buffer che riceve il percorso completo del file dbg.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle aperto al file dbg.
Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
La funzione FindDebugInfoFile viene usata per individuare un file con estensione dbg. Questa funzione viene fornita in modo che la ricerca possa essere eseguita in diverse directory diverse tramite una singola chiamata di funzione. Il parametro SymbolPath può contenere più percorsi, separati da un punto e virgola (;). Quando vengono specificati più percorsi, la funzione cerca ogni directory per il file. Le sottodirectory non vengono eseguite ricerche. Quando si trova il file, la ricerca si arresta. Assicurarsi quindi di specificare SymbolPath con i percorsi nell'ordine corretto.
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | dbghelp.h |
| Libreria | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Componente ridistribuibile | DbgHelp.dll 5.1 o versioni successive |