Compartir a través de


AfxFreeLibrary

AfxFreeLibrary y AfxLoadLibrary mantienen un recuento de referencia para cada módulo cargado de biblioteca.

BOOL AFXAPI AfxFreeLibrary(
   HINSTANCE hInstLib 
);

Parámetros

  • hInstLib
    Un identificador de módulo cargado de biblioteca.AfxLoadLibrary devuelve este identificador.

Valor devuelto

TRUE si la función tiene éxito; si no, FALSE.

Comentarios

AfxFreeLibrary disminuye el recuento de referencias del módulo cargado (DLL) de biblioteca de vínculos dinámicos.Cuando el recuento de referencias llega a cero, el módulo es no asignados del espacio de direcciones del proceso de llamada y el identificador ya no es válido.Se incrementa este recuento de referencia cada vez que se llama a AfxLoadLibrary .

Antes de quitar de una tarea de un módulo de la biblioteca, el sistema permite a DLL desasociarse de los procesos de usarla.Al hacerlo se proporciona a DLL una oportunidad de limpiar los recursos asignados en nombre de la actual procesa.Después de que la función de punto de entrada vuelve, el módulo de la biblioteca se quita el espacio de direcciones del proceso actual.

Uso AfxLoadLibrary de asignar un módulo de DLL.

Asegúrese de utilizar AfxFreeLibrary y AfxLoadLibrary (en lugar de Win32 funciona FreeLibrary y LoadLibrary) si la aplicación utiliza varios subprocesos.El uso de AfxLoadLibrary y AfxFreeLibrary garantiza que el código de inicio y de cierre que se ejecuta cuando se carga o descarga el archivo DLL de extensión no dañe el estado global de MFC.

Ejemplo

Vea el ejemplo para AfxLoadLibrary.

Requisitos

Header: afxdll_.h

Vea también

Referencia

AfxLoadLibrary

Conceptos

Macros y funciones globales de MFC