Funzione SymFindExecutableImage (dbghelp.h)

  • Articolo

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

Vedi anche

Funzioni DbgHelp

FindExecutableImageProc