AfxFreeLibrary
AfxFreeLibrary und AfxLoadLibrary behalten einen Verweiszähler für jedes geladene Bibliotheksmodul bei.
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
Parameter
- hInstLib
Ein Handle des geladenen Bibliotheksmoduls. AfxLoadLibrary gibt dieses Handle zurück.
Rückgabewert
TRUE, wenn die Funktion erfolgreich verläuft; andernfalls FALSE.
Hinweise
AfxFreeLibrary verringert den Verweiszähler des geladenen Dynamic Link Library-Version (DLL)- Moduls. Wenn der Verweiszähler Null erreicht, wird das Modul im Adressbereich des aufrufenden Prozesses die Zuordnung aufgehoben und das Handle ist nicht mehr gültig. Dieser Verweiszählers wird erhöht, wenn AfxLoadLibrary aufgerufen wird.
Bevor der eines Bibliotheksmoduls die Zuordnung wird, kann das System die DLL, um von den Prozessen mithilfe es zu trennen. Dies gibt der DLL eine Gelegenheit, sodass Ressourcen zu bereinigen, die im Namen des aktuellen zugeordnet sind, verarbeitet. Nachdem die Einstiegspunktfunktion zurückgegeben wird, wird das Bibliotheksmodul im Adressbereich des aktuellen Prozesses entfernt.
Verwendung von AfxLoadLibrary, ein DLL-Modul zuzuordnen.
Stellen Sie sicher, AfxFreeLibrary und AfxLoadLibrary zu verwenden (anstelle der Win32-Funktionen FreeLibrary und LoadLibrary), wenn die Anwendung mehrere Threads verwendet. Die Verwendung von AfxLoadLibrary und AfxFreeLibrary stellt sicher, dass der Code für das Starten und Beenden, der beim Laden und beim Entladen der Erweiterungs-DLL ausgeführt wird, den globalen MFC-Zustand nicht beschädigt.
Beispiel
Im Beispiel für AfxLoadLibrary.
Anforderungen
Header: afxdll_.h