AfxFreeLibrary
Sia AfxFreeLibrary che AfxLoadLibrary mantengono un conteggio dei riferimenti per ogni modulo di libreria caricato.
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
Parametri
- hInstLib
Handle del modulo di libreria caricato. AfxLoadLibrary restituisce questo handle.
Valore restituito
TRUE se la funzione viene eseguita correttamente; in caso contrario, FALSE.
Note
AfxFreeLibrary decrementa il conteggio dei riferimenti del modulo di libreria a collegamento dinamico (DLL). Quando il conteggio dei riferimenti arriva a zero, il modulo viene disassociato dallo spazio degli indirizzi del processo chiamante e l'handle non è più valido. Questo conteggio dei riferimenti viene incrementato ogni volta che viene chiamata AfxLoadLibrary.
Prima di disassociare un modulo di libreria, il sistema consente alla DLL di rimuoverlo dai processi che lo stanno utilizzando. Questa operazione consente alla DLL di liberare le risorse allocate per conto del processo corrente. Dopo il completamento della funzione del punto di ingresso, il modulo di libreria viene rimosso dallo spazio degli indirizzi del processo corrente.
Utilizzare AfxLoadLibrary per eseguire il mapping di un modulo DLL.
Accertarsi di utilizzare AfxFreeLibrary e AfxLoadLibrary, anziché le funzioni Win32 FreeLibrary e LoadLibrary, se si utilizzano più thread nell'applicazione. L'utilizzo di AfxLoadLibrary e AfxFreeLibrary assicura che nel codice di avvio e di chiusura eseguito quando si carica e si scarica la DLL di estensione non vi sia nulla che danneggi lo stato MFC globale.
Esempio
Vedere l'esempio per AfxLoadLibrary.
Requisiti
Intestazione: afxdll_.h