AfxFreeLibrary
AfxFreeLibrary e AfxLoadLibrary mantêm uma contagem de referência para cada módulo carregado da biblioteca.
BOOL AFXAPI AfxFreeLibrary(
HINSTANCE hInstLib
);
Parâmetros
- hInstLib
Um identificador de módulo carregado de biblioteca. AfxLoadLibrary retorna este identificador.
Valor de retorno
Verdadeiro se a função for bem-sucedida; caso contrário, Falso.
Comentários
AfxFreeLibrary diminui a contagem de referência do módulo carregado (DLL) de biblioteca de vínculo dinâmico (DLL). Quando a contagem de referência chegar a zero, o módulo não foi mapeada de espaço de endereço do processo de chamada e ao identificador não é mais válida. Essa contagem de referência é incrementado sempre que AfxLoadLibrary é chamado.
Antes de unmapping um módulo de biblioteca, o sistema permite que a DLL para desanexar dos processos usando o. Fazer isso para a DLL fornece uma oportunidade de limpar os recursos alocados em nome do processo atual. Depois que a função de ponto de retornar, o módulo da biblioteca é removido do espaço de endereço do processo atual.
Use AfxLoadLibrary para mapear um módulo DLL.
Certifique-se de usar AfxFreeLibrary e AfxLoadLibrary (em vez do Win32 funcionam FreeLibrary e LoadLibrary) se seu aplicativo usa vários threads. Usar AfxLoadLibrary e AfxFreeLibrary garante que a inicialização e o desligamento codifiquem que executa a DLL de extensão é carregado e descarregado não compromete o estado global de MFC.
Exemplo
Consulte o exemplo de AfxLoadLibrary.
Requisitos
Header: afxdll_.h