SymUnloadModule, fonction (dbghelp.h)
Décharge la table de symboles.
Syntaxe
BOOL IMAGEAPI SymUnloadModule(
[in] HANDLE hProcess,
[in] DWORD BaseOfDll
);
Paramètres
[in] hProcess
Handle du processus qui a été passé à l’origine à la fonction SymInitialize.
[in] BaseOfDll
Adresse de base du module à décharger.
Valeur de retour
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
Toutes les fonctions DbgHelp, comme celle-ci, sont monothread. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement une altération inattendue du comportement ou de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.
La fonction SymUnloadModule64 remplace cette fonction. Pour plus d’informations, consultez mise à jour de la prise en charge de la plateforme. SymUnloadedModule est défini comme suit dans Dbghelp.h.
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymUnloadModule SymUnloadModule64
#else
BOOL
IMAGEAPI
SymUnloadModule(
__in HANDLE hProcess,
__in DWORD BaseOfDll
);
#endif
Exemples
Pour obtenir un exemple, consultez déchargement d’un module symbole.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | dbghelp.h |
| bibliothèque | Dbghelp.lib |
| DLL | Dbghelp.dll |
| redistribuable | DbgHelp.dll 5.1 ou version ultérieure |