Fonction SymGetSourceFile (dbghelp.h)

  • Article

Récupère le fichier source spécifié à partir du serveur source.

Syntaxe

BOOL IMAGEAPI SymGetSourceFile(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCSTR   Params,
  [in]           PCSTR   FileSpec,
  [out]          PSTR    FilePath,
  [in]           DWORD   Size
);

Paramètres

[in] hProcess

Handle d’un processus. Ce handle doit avoir été précédemment passé à la fonction SymInitialize .

[in] Base

Adresse de base du module.

[in, optional] Params

Ce paramètre est inutilisé.

[in] FileSpec

Nom du fichier source.

[out] FilePath

Pointeur vers une mémoire tampon qui reçoit le chemin complet du fichier source.

[in] Size

Taille de la mémoire tampon FilePath , en caractères.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

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

Notes

Pour contrôler le répertoire qui reçoit les fichiers sources, utilisez la fonction SymSetHomeDirectory .

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 6.2 ou version ultérieure

Voir aussi

Fonctions DbgHelp

Serveur source