Funzione FindExecutableImageEx (dbghelp.h)
Individua il file eseguibile specificato.
Sintassi
HANDLE IMAGEAPI FindExecutableImageEx(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR ImageFilePath,
[in, optional] PFIND_EXE_FILE_CALLBACK Callback,
[in, optional] PVOID CallerData
);
Parametri
[in] FileName
Nome del file di simboli da individuare. Questo parametro può essere un percorso parziale.
[in] SymbolPath
Percorso in cui si trovano i file di simboli. Questa stringa può contenere più percorsi separati da punto e virgola. Per recuperare il percorso del simbolo, usare la funzione SymGetSearchPath .
[out] ImageFilePath
Puntatore a un buffer che riceve il percorso completo del file eseguibile.
[in, optional] Callback
Funzione di callback definita dall'applicazione che verifica se è stato trovato il file eseguibile corretto o se la funzione deve continuare la ricerca. Per altre informazioni, vedere FindExecutableImageProc.
Questo parametro può essere NULL.
[in, optional] CallerData
Dati facoltativi definiti dall'utente per la funzione di callback. Questo parametro può essere NULL.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle aperto per il file eseguibile.
Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
La funzione FindExecutableImageEx viene fornita in modo che i file eseguibili si trovino in diverse directory usando una singola chiamata di funzione. Se il parametro SymbolPath contiene più percorsi, la funzione cerca il file eseguibile in ogni albero di directory specificato. Quando il file viene trovato, la ricerca viene arrestata. Assicurarsi quindi di specificare SymbolPath con i percorsi nell'ordine corretto.
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.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | dbghelp.h |
| Libreria | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Componente ridistribuibile | DbgHelp.dll 5.1 o versione successiva |