AfxFreeLibrary

BOOL AFXAPI AfxFreeLibrary (HINSTANCE hInstLib);

Valor de retorno

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

Parâmetros

hInstLib

Um identificador do módulo carregado biblioteca. AfxLoadLibrary retorna esse identificador.

Observações

AfxFreeLibrary e AfxLoadLibrary mantém uma Contar de referência para cada módulo carregado biblioteca. AfxFreeLibrary diminui a referência contar do módulo carregado biblioteca de vínculo dinâmico (DLL). Quando o contagem de referência atingir zero, o módulo é não mapeado do espaço de endereço do processo de chamada e o identificador é não mais válido. Esta contagem de referência é incrementada sempre que AfxLoadLibrary é chamado.

Antes de unmapping um módulo de biblioteca, o sistema permite a DLL desanexar de processos usando-o. Isso oferece a DLL de uma oportunidade para limpar recursos alocados on behalf of o atual processo. Depois que a função de ponto de entrada retorna, 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 do Win32 funções FreeLibrary e LoadLibrary) se seu aplicativo usa Múltiplo segmentos. 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.

Co&nsulte tambémnbsp;AfxLoadLibrary

Index