Partager via


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

Voir aussi

Fonctions DbgHelp

FindExecutableImageProc

SymGetSearchPath