FindExecutableImageExW, fonction (dbghelp.h)
Recherche le fichier exécutable spécifié.
Syntaxe
HANDLE IMAGEAPI FindExecutableImageExW(
[in] PCWSTR FileName,
[in] PCWSTR SymbolPath,
[out] PWSTR ImageFilePath,
[in, optional] PFIND_EXE_FILE_CALLBACKW 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 du symbole, 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.
[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 de retour
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.
Note
L’en-tête dbghelp.h définit FindExecutableImageEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | dbghelp.h |
| bibliothèque | Dbghelp.lib |
| DLL | Dbghelp.dll |
| redistribuable | DbgHelp.dll 5.1 ou version ultérieure |