Función FreeLibraryAndExitThread (libloaderapi.h)

  • Artículo

Disminuye el recuento de referencias de una biblioteca de vínculos dinámicos (DLL) cargada por uno y, a continuación, llama a ExitThread para finalizar el subproceso que realiza la llamada. La función no devuelve .

Sintaxis

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

Parámetros

[in] hLibModule

Identificador del módulo DLL cuya referencia cuenta los decrementos de la función. La función LoadLibrary o GetModuleHandleEx devuelve este identificador.

No llame a esta función con un identificador devuelto por la función GetModuleHandleEx (con la marca GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT) o la función GetModuleHandle , ya que no mantienen un recuento de referencias para el módulo.

[in] dwExitCode

Código de salida del subproceso que llama.

Valor devuelto

None

Observaciones

La función FreeLibraryAndExitThread permite que los subprocesos que se ejecutan dentro de un archivo DLL liberen de forma segura el archivo DLL en el que se ejecutan y finalizan ellos mismos. Si llamaran a FreeLibrary y ExitThread por separado, existiría una condición de carrera. La biblioteca se puede descargar antes de llamar a ExitThread .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado libloaderapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

DisableThreadLibraryCalls

Funciones de la biblioteca de vínculos dinámicos

ExitThread

FreeLibrary

Vinculación dinámica en tiempo de ejecución