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 |