Funzione FindExecutableImageEx (dbghelp.h)

  • Articolo

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

Vedi anche

Funzioni DbgHelp

FindExecutableImageProc

SymGetSearchPath