Share via

Fonction SymSrvGetSupplement (dbghelp.h)

  • Article

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

Voir aussi

Fonctions DbgHelp

SymSrvStoreSupplement