Função FreeLibraryAndExitThread (libloaderapi.h)

Diminui a contagem de referência de uma DLL (biblioteca de vínculo dinâmico) carregada por um e, em seguida, chama ExitThread para encerrar o thread de chamada. A função não retorna.

Sintaxe

void FreeLibraryAndExitThread(
  [in] HMODULE hLibModule,
  [in] DWORD   dwExitCode
);

Parâmetros

[in] hLibModule

Um identificador para o módulo DLL cuja referência conta os decrementos da função. A função LoadLibrary ou GetModuleHandleEx retorna esse identificador.

Não chame essa função com um identificador retornado pela função GetModuleHandleEx (com o sinalizador GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT) ou pela função GetModuleHandle , pois elas não mantêm uma contagem de referência para o módulo.

[in] dwExitCode

O código de saída para o thread de chamada.

Retornar valor

Nenhum

Comentários

A função FreeLibraryAndExitThread permite que os threads que estão sendo executados em uma DLL liberem com segurança a DLL na qual estão sendo executados e se encerrem. Se eles chamassem FreeLibrary e ExitThread separadamente, uma condição de corrida existiria. A biblioteca pode ser descarregada antes de ExitThread ser chamado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho libloaderapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Disablethreadlibrarycalls

Funções de biblioteca de link dinâmico

ExitThread

FreeLibrary

Vinculação dinâmica em tempo de execução