Fonction SymSrvGetSupplement (dbghelp.h)
Récupère le fichier spécifié à partir du supplément d’un magasin de symboles.
Syntaxe
PCSTR IMAGEAPI SymSrvGetSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SymPath,
[in] PCSTR Node,
[in] PCSTR File
);
Paramètres
[in] hProcess
Handle d’un processus. Ce handle doit avoir été précédemment passé à la fonction SymInitialize .
[in, optional] SymPath
Chemin du symbole. La fonction utilise uniquement les magasins de symboles décrits dans la syntaxe standard pour les magasins de symboles. Tous les autres chemins d’accès sont ignorés. Si ce paramètre a la valeur NULL, la fonction utilise le chemin de symbole défini à l’aide de la fonction SymInitialize ou SymSetSearchPath .
[in] Node
Fichier de symboles associé au fichier supplémentaire.
[in] File
Nom du fichier.
Valeur retournée
Si la fonction réussit, la valeur de retour est le chemin complet du fichier supplémentaire.
Si la fonction échoue, la valeur de retour est NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Remarques
Pour plus d’informations sur les fichiers supplémentaires, consultez SymSrvStoreSupplement.
Cette fonction retourne un pointeur vers une mémoire tampon qui peut être réutilisée par une autre fonction. Par conséquent, veillez à copier immédiatement les données retournées dans une autre mémoire tampon.
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.
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.3 ou version ultérieure |