FreeLibrary

9/8/2008

Essa função diminui a contagem de referência do módulo carregado DLL.

Quando o contagem de referência atingir zero, o módulo é desmapeado a partir de espaço de endereço de processo de chamada e o identificador não é mais válido.

Syntax

BOOL FreeLibrary(
  HMODULE hLibModule
);

Parameters

• hLibModule
  [no] Identificador para o módulo carregado biblioteca.

  O LoadLibrary, LoadLibraryExou GetModuleHandle função retorna esse identificador.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Cada processo mantém um contagem de referência para cada módulo biblioteca carregada. Este contagem de referência é incrementado cada tempo LoadLibrary é chamado e é diminuído cada tempo FreeLibrary é chamado.

Um módulo DLL carregadas na inicialização processo carregar devido a-dinâmico tempo vinculando tem um contagem de referência de um. Esta contagem é incrementada se o mesmo módulo estiver carregado por um chamar para LoadLibrary.

Antes unmapping um módulo biblioteca, o sistema permite que o DLL para desanexar a partir de processo, chamado função DllMain do DLL, se ele tiver um, com o valor DLL_PROCESS_DETACH. Isso oferece o DLL a oportunidade para limpar os recursos alocados on Behalf Of o atual processo.

Após a entrada-função apontar retorna, o módulo biblioteca é removido de espaço de endereço do processo.

Ele não é seguro para chamar FreeLibrary a partir DllMain. Para obter mais informações, consulte a seção " Comentários " em DllMain.

Chamando FreeLibrary Não afeta outros processos que usam o mesmo módulo biblioteca.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

DLL Functions
GetModuleHandle
DllMain
LoadLibrary
LoadLibraryEx