AfxFreeLibrary

AfxLoadLibrary und behalten AfxFreeLibrary einen Verweiszähler für jedes geladene Modul Bibliothek gespeichert.

BOOL AFXAPI AfxFreeLibrary(
   HINSTANCE hInstLib 
);

Parameter

  • hInstLib
    Ein Handle des geladenen moduls Bibliothek.AfxLoadLibrary gibt dieses Handle zurück.

Rückgabewert

TRUE, wenn die Funktion erfolgreich ausgeführt wird; andernfalls FALSE.

Hinweise

AfxFreeLibrary dekrementiert den Verweiszähler des geladenen Moduls der DLL (Dynamic Link Library).Wenn der Verweiszähler (null) erreicht, wird das Modul im Adressbereich des aufrufenden Prozesses Zuordnung aufgehoben und das Handle ist nicht mehr gültig.Dieser Verweiszähler wird jedes Mal inkrementiert, wenn AfxLoadLibrary aufgerufen wird.

Bevor ein Modul Bibliothek Zuordnung aufgehoben wird, kann das System die DLL, um von den Prozessen wobei es zu trennen.Dadurch wird die DLL so die Möglichkeit, Ressourcen zu bereinigen, die im Auftrag der aktuellen Kultur zugeordnet sind, verarbeitet.Nachdem die Einstiegspunktfunktion gibt, wird das Modul Bibliothek im Adressbereich des aktuellen Prozesses entfernt.

Verwendung AfxLoadLibrary, ein DLL-Modul zuzuordnen.

Stellen Sie sicher, AfxFreeLibrary und AfxLoadLibrary zu verwenden (und nicht funktioniert FreeLibrary Win32- 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

Weitere Informationen finden Sie im Beispiel für AfxLoadLibrary.

Anforderungen

Header: afxdll_.h

Siehe auch

Referenz

AfxLoadLibrary

Konzepte

MFC-Makros und -globale Werte