Fonction FindExecutableImageEx (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 à trouver. 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 du symbole, utilisez la fonction SymGetSearchPath .
[out] ImageFilePath
Pointeur vers une mémoire tampon qui reçoit le chemin complet du fichier exécutable.
[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 retournée
Si la fonction réussit, la valeur de retour est un handle ouvert pour le fichier exécutable.
Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Notes
La fonction FindExecutableImageEx est fournie pour que les fichiers exécutables puissent être 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 le fichier exécutable dans chaque arborescence de répertoires spécifiée. 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, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération 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.
Spécifications
| Plateforme cible | Windows |
| En-tête | dbghelp.h |
| Bibliothèque | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Composant redistribuable | DbgHelp.dll 5.1 ou version ultérieure |