FindExecutableImageEx, fonction (dbghelp.h)

Recherche le fichier exécutable spécifié.

Syntaxe

HANDLE IMAGEAPI FindExecutableImageEx(
  [in]           PCSTR                   FileName,
  [in]           PCSTR                   SymbolPath,
  [out]          PSTR                    ImageFilePath,
  [in, optional] PFIND_EXE_FILE_CALLBACK Callback,
  [in, optional] PVOID                   CallerData
);

Paramètres

[in] FileName

Nom du fichier de symboles à localiser. Ce paramètre peut être un chemin d’accès partiel.

[in] SymbolPath

Chemin d’accès où se trouvent les fichiers de symboles. Cette chaîne peut contenir plusieurs chemins séparés par des points-virgules. Pour récupérer le chemin d’accès aux symboles, utilisez la fonction SymGetSearchPath .

[out] ImageFilePath

Pointeur vers une mémoire tampon qui reçoit le chemin d’accès complet du fichier exécutable. Cette mémoire tampon doit être au moins MAX_PATH+1 caractères.

[in, optional] Callback

Fonction de rappel définie par l’application qui vérifie si le fichier exécutable correct a été trouvé ou si la fonction doit poursuivre sa recherche. Pour plus d’informations, consultez FindExecutableImageProc.

Ce paramètre peut être NULL.

[in, optional] CallerData

Données facultatives définies par l’utilisateur pour la fonction de rappel. Ce paramètre peut être NULL.

Valeur renvoyée

Si la fonction réussit, la valeur de retour est un handle ouvert au fichier exécutable.

Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

La fonction FindExecutableImageEx est fournie afin que les fichiers exécutables soient trouvés dans plusieurs répertoires différents à l’aide d’un seul appel de fonction. Si le paramètre SymbolPath contient plusieurs chemins d’accès, la fonction recherche chaque arborescence de répertoires spécifiée pour le fichier exécutable. Lorsque le fichier est trouvé, la recherche s’arrête. Par conséquent, veillez à spécifier SymbolPath avec les chemins dans l’ordre correct.

Toutes les fonctions DbgHelp, comme celle-ci, sont monothread. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement une altération inattendue du comportement ou de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Pour appeler la version Unicode de cette fonction, définissez DBGHELP_TRANSLATE_TCHAR.

Exigences

Voir aussi

fonctions DbgHelp

FindExecutableImageProc

SymGetSearchPath