Funzione FindDebugInfoFileEx (dbghelp.h)

Individua il file di debug (con estensione dbg) specificato.

Sintassi

HANDLE IMAGEAPI FindDebugInfoFileEx(
  [in]           PCSTR                     FileName,
  [in]           PCSTR                     SymbolPath,
  [out]          PSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
  [in, optional] PVOID                     CallerData
);

Parameters

[in] FileName

Nome del file con estensione dbg da individuare. È possibile usare un percorso parziale.

[in] SymbolPath

Percorso in cui si trovano i file di simboli. Può trattarsi di più percorsi separati da punti e virgola. Per recuperare il percorso del simbolo, utilizzare la funzione SymGetSearchPath .

[out] DebugFilePath

Puntatore a un buffer che riceve il percorso completo del file con estensione dbg. Questo buffer deve essere almeno MAX_PATH+1 caratteri.

[in, optional] Callback

Funzione di callback definita dall'applicazione che verifica se il file corretto è stato trovato o se la funzione deve continuare la ricerca. Per altre informazioni, vedere FindDebugInfoFileProc.

Questo parametro può essere NULL.

[in, optional] CallerData

Dati facoltativi definiti dall'utente da passare alla funzione di callback.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle aperto per il file con estensione dbg.

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni:

La funzione FindDebugInfoFileEx viene usata per individuare un file con estensione dbg. Questa funzione viene fornita in modo che la ricerca possa essere eseguita in diverse directory tramite una singola chiamata di funzione. Il parametro SymbolPath può contenere più percorsi, ognuno separato da un punto e virgola (;). Quando vengono specificati più percorsi, la funzione cerca il file in ogni directory specificata. Quando il file si trova, la ricerca viene arrestata. Assicurarsi quindi di specificare SymbolPath con i percorsi nell'ordine corretto.

Se il nome file specificato non include un'estensione dbg, FindDebugInfoFileEx cerca il file nella sequenza seguente:

  1. SymbolPath\Symbols\ext\filename.dbg
  2. SymbolPath\ext\filename.dbg
  3. SymbolPath\filename.dbg
  4. FileNamePath\filename.dbg
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.

Requisiti

Requisito Value
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Raccolta Dbghelp.lib
DLL Dbghelp.dll
Ridistribuibile DbgHelp.dll 5.1 o versione successiva

Vedere anche

Funzioni DbgHelp

FindDebugInfoFileProc

SymGetSearchPath

  • Last updated on