Funzione SymFindDebugInfoFile (dbghelp.h)
Individua un file con estensione dbg nel percorso di ricerca del processo.
Sintassi
HANDLE IMAGEAPI SymFindDebugInfoFile(
[in] HANDLE hProcess,
[in] PCSTR FileName,
[out] PSTR DebugFilePath,
[in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
[in, optional] PVOID CallerData
);
Parametri
[in] hProcess
Handle per il processo passato originariamente alla funzione SymInitialize .
[in] FileName
Nome del file dbg. È possibile usare un percorso parziale.
[out] DebugFilePath
Percorso completo del file dbg. Questo buffer deve essere almeno MAX_PATH caratteri.
[in, optional] Callback
Funzione di callback definita dall'applicazione che verifica se il file corretto è stato trovato o la funzione deve continuare la ricerca. Per altre informazioni, vedere FindDebugInfoFileProc.
Questo parametro può essere NULL.
[in, optional] CallerData
Valore definito dall'utente o NULL. Questo valore viene semplicemente passato alla funzione di callback. Questo parametro viene in genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce un contesto per la funzione di callback.
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
Questa funzione usa il percorso di ricerca impostato usando la funzione SymInitialize o SymSetSearchPath .
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
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | dbghelp.h |
Libreria | Dbghelp.lib |
DLL | Dbghelp.dll |
Componente ridistribuibile | DbgHelp.dll 6.6 o versioni successive |