Funzione FindExecutableImage (dbghelp.h)

Individua un file eseguibile.

Per specificare una funzione di callback, usare la funzione FindExecutableImageEx .

Sintassi

HANDLE IMAGEAPI FindExecutableImage(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  ImageFilePath
);

Parameters

[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. Può trattarsi di più percorsi separati da punti e virgola. Per recuperare il percorso del simbolo, utilizzare la funzione SymGetSearchPath .

[out] ImageFilePath

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

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.

Osservazioni:

La funzione FindExecutableImage viene fornita in modo che i file eseguibili possano trovarsi 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 eseguibile in ogni albero di directory. Quando il file si trova, 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. 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.

Requisiti

Vedere anche

Funzioni DbgHelp

FindExecutableImageEx

SymGetSearchPath