Compartilhar via


AfxFreeLibrary

Ambos AfxFreeLibrary e AfxLoadLibrary manter uma contagem de referência para cada módulo carregado biblioteca.

BOOL AFXAPI AfxFreeLibrary(
   HINSTANCE hInstLib 
);

Parâmetros

  • hInstLib
    Identificador do módulo carregado biblioteca.AfxLoadLibrary retorna esse identificador.

Valor de retorno

TRUE se a função for bem-sucedida; Caso contrário, FALSE.

Comentários

AfxFreeLibrarydiminui a referência contar do módulo carregado biblioteca de vínculo dinâmico (DLL).Quando a contagem de referência atinge zero, o módulo é não mapeado no espaço de endereço do processo de chamada e o identificador não é válido.A contagem de referência é incrementada cada vez AfxLoadLibrary é chamado.

Antes de unmapping um módulo de biblioteca, o sistema permite desanexar de processos usando a DLL.Isso a DLL de uma oportunidade para limpar recursos alocados em nome do processo atual.Depois retorna a função de ponto de entrada, o módulo 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 de funções Win32 FreeLibrary e LoadLibrary) se seu aplicativo usa vários threads.Usando AfxLoadLibrary e AfxFreeLibrary garante que o código de inicialização e desligamento que executa quando a extensão DLL é carregado e descarregado não corromper o estado global do MFC.

Exemplo

Consulte o exemplo para AfxLoadLibrary.

Requisitos

Cabeçalho: afxdll_.h

Consulte também

Referência

AfxLoadLibrary

Conceitos

Globais e Macros do MFC