AfxFreeLibrary
A la fois AfxFreeLibrary et AfxLoadLibrary contiennent un compteur de référence pour chaque module de bibliothèque chargé.
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
Paramètres
- hInstLib
Un descripteur du module chargé de bibliothèque. AfxLoadLibrary retourne ce handle.
Valeur de retour
TRUE si la fonction aboutit ; sinon, FALSE.
Notes
AfxFreeLibrary décrémente le nombre de références du module chargé de bibliothèque de liens dynamiques (DLL). Lorsque le compteur de références atteint zéro, le module est démappé de l'espace d'adressage du processus appelant et le handle n'est plus valide. Ce compteur de références est incrémenté chaque fois que AfxLoadLibrary est appelé.
Avant la libération d'un module de bibliothèque, le système permet à la DLL de se dissocier des processus qui l'utilisent. Cela donne donc à la DLL la possibilité de nettoyer les ressources allouées au nom du processus actuel. Après la fonction de point d'entrée ait effecuté le retour, le module de bibliothèque est supprimé de l'espace d'adressage de processus actuel.
Utilisez AfxLoadLibrary pour mapper un module DLL.
Assurez-vous d'utiliser AfxFreeLibrary et AfxLoadLibrary (à la place des fonctions Win32 FreeLibrary et LoadLibrary) si votre application utilise plusieurs threads. L'utilisation de AfxLoadLibrary et de AfxFreeLibrary fait en sorte que le code de démarrage et d'arrêt qui s'exécute lors du chargement et du déchargement de la DLL d'extension n'altère pas l'état global des MFC.
Exemple
Consultez l'exemple pour AfxLoadLibrary.
Configuration requise
En-tête : afxdll_.h