Fonction SymLoadModule (dbghelp.h)

  • Article

Charge la table de symboles.

Cette fonction a été remplacée par la fonction SymLoadModuleEx .

Syntaxe

DWORD IMAGEAPI SymLoadModule(
  [in]           HANDLE hProcess,
  [in, optional] HANDLE hFile,
  [in, optional] PCSTR  ImageName,
  [in, optional] PCSTR  ModuleName,
  [in]           DWORD  BaseOfDll,
  [in]           DWORD  SizeOfDll
);

Paramètres

[in] hProcess

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

[in, optional] hFile

Handle du fichier pour l’image exécutable. Cet argument est principalement utilisé par les débogueurs, où le débogueur transmet le handle de fichier obtenu à partir d’un événement de débogage. La valeur NULL indique que hFile n’est pas utilisé.

[in, optional] ImageName

Nom de l’image exécutable. Ce nom peut contenir un chemin d’accès partiel, un chemin d’accès complet ou aucun chemin du tout. Si le fichier ne peut pas être localisé par le nom fourni, le chemin de recherche de symbole est utilisé.

[in, optional] ModuleName

Nom de raccourci pour le module. Si la valeur du pointeur est NULL, la bibliothèque crée un nom à l’aide du nom de base du fichier de symboles.

[in] BaseOfDll

Adresse de chargement du module. Si la valeur est égale à zéro, la bibliothèque obtient l’adresse de chargement à partir du fichier de symboles. L’adresse de charge contenue dans le fichier de symboles n’est pas nécessairement l’adresse de chargement réelle. Les débogueurs et autres applications ayant une adresse de charge réelle doivent utiliser l’adresse de charge réelle lors de l’appel de cette fonction.

Si l’image est un fichier .pdb, ce paramètre ne peut pas être égal à zéro.

[in] SizeOfDll

Taille du module, en octets. Si la valeur est zéro, la bibliothèque obtient la taille à partir du fichier de symboles. La taille contenue dans le fichier de symboles n’est pas nécessairement la taille réelle. Les débogueurs et autres applications ayant une taille réelle doivent utiliser la taille réelle lors de l’appel de cette fonction.

Si l’image est un fichier .pdb, ce paramètre ne peut pas être égal à zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est l’adresse de base du module chargé.

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

Si le module est déjà chargé, la valeur de retour est zéro et GetLastError retourne ERROR_SUCCESS.

Notes

Le gestionnaire de symboles crée une entrée pour le module et si l’option de chargement différé des symboles est désactivée, une tentative de chargement des symboles est effectuée. Si le chargement différé des symboles est activé, le module est marqué comme différé et les symboles ne sont pas chargés tant qu’une référence à un symbole n’est pas faite dans le module.

Pour décharger la table de symboles, utilisez la fonction SymUnloadModule64 .

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.

Cette fonction remplace la fonction SymLoadModule . Pour plus d’informations, consultez Mise à jour de la prise en charge de la plateforme. SymLoadModule est défini comme suit dans DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymLoadModule SymLoadModule64
#else
DWORD
IMAGEAPI
SymLoadModule(
    __in HANDLE hProcess,
    __in_opt HANDLE hFile,
    __in_opt PCSTR ImageName,
    __in_opt PCSTR ModuleName,
    __in DWORD BaseOfDll,
    __in DWORD SizeOfDll
    );
#endif

Spécifications

   
Plateforme cible Windows
En-tête dbghelp.h
Bibliothèque Dbghelp.lib
DLL Dbghelp.dll
Composant redistribuable DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

SymInitialize

SymUnloadModule64