AfxFreeLibrary
AfxFreeLibrary et AfxLoadLibrary contiennent un décompte de références pour chaque module chargé de bibliothèque.
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
Paramètres
- hInstLib
Un handle du module chargé de bibliothèque.AfxLoadLibrary retourne ce handle.
Valeur de retour
TRUE si la fonction réussit ; sinon, FALSE.
Notes
AfxFreeLibrary décrémente le décompte de références du module chargé (DLL) de bibliothèque de liens dynamiques.Lorsque le décompte de références atteint zéro, le module est non mappés 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 du plan au projet d'équipe un module de bibliothèque, le système permet à la DLL pour détacher des processus à l'aide de lui.Ce fait ainsi à la DLL la possibilité de nettoyer les ressources allouées au nom de en cours de traitement.Une fois que la fonction de point d'entrée retourne, le module de bibliothèque est supprimé de l'espace d'adressage du processus actuel.
Utilisation AfxLoadLibrary de mapper un module DLL.
Veillez à utiliser AfxFreeLibrary et AfxLoadLibrary (au lieu de Win32 s'exécute 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
Header: afxdll_.h