Funzione SymFindExecutableImage (dbghelp.h)
Individua un file eseguibile nel percorso di ricerca del processo.
Sintassi
HANDLE IMAGEAPI SymFindExecutableImage(
[in] HANDLE hProcess,
[in] PCSTR FileName,
[out] PSTR ImageFilePath,
[in] PFIND_EXE_FILE_CALLBACK Callback,
[in] PVOID CallerData
);
Parametri
[in] hProcess
Handle per il processo passato originariamente alla funzione SymInitialize .
[in] FileName
Nome del file eseguibile. È possibile usare un percorso parziale.
[out] ImageFilePath
Percorso completo del file eseguibile. Questo buffer deve essere almeno MAX_PATH caratteri.
[in] 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] 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 eseguibile.
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 |