Função FreeLibraryAndExitThread (libloaderapi.h)

Artigo
02/28/2024

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