Fonction SplitSymbols (imagehlp.h)

Supprime les symboles de l’image spécifiée.

Syntaxe

BOOL IMAGEAPI SplitSymbols(
  [in]  PSTR  ImageName,
  [in]  PCSTR SymbolsPath,
  [out] PSTR  SymbolFilePath,
  [in]  ULONG Flags
);

Paramètres

[in] ImageName

Nom de l’image à partir de laquelle fractionner les symboles.

[in] SymbolsPath

Sous-répertoire pour le stockage des symboles. Ce paramètre est facultatif.

[out] SymbolFilePath

Nom du fichier de symboles généré. Ce fichier a généralement une extension .dbg.

[in] Flags

Informations à fractionner de l’image. Ce paramètre peut être égal à zéro ou à une combinaison des valeurs suivantes.

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

La fonction SplitSymbols doit être utilisée lors de la suppression des symboles d’une image. Il crée un fichier de symboles que tous les débogueurs compatibles comprennent. Le format est défini dans WinNT.h et se compose d’un en-tête d’image, suivi du tableau d’en-têtes de section, des informations FPO et de toutes les informations symboliques de débogage de l’image.

Si le paramètre SymbolsPath a la valeur NULL, le fichier de symboles est stocké dans le répertoire où l’image existe. Sinon, il est stocké dans le sous-répertoire sous SymbolsPath qui correspond à l’extension de l’image. L’utilisation de cette méthode réduit les risques de collision de fichier de symboles. Par exemple, les symboles de myapp.exe se trouveront dans le répertoire SymbolsPath\exe et les symboles de myapp.dll se trouveront dans le répertoire SymbolsPath\dll.

Toutes les fonctions ImageHlp, 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.

Configuration requise

Voir aussi

Fonctions ImageHlp