Fonction SymGetSourceFileW (dbghelp.h)

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

Syntaxe

BOOL IMAGEAPI SymGetSourceFileW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCWSTR  Params,
  [in]           PCWSTR  FileSpec,
  [out]          PWSTR   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.

Remarques

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.

Notes

L’en-tête dbghelp.h définit SymGetSourceFile en tant qu’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. La combinaison 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.

Configuration requise

Condition requise Valeur
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