AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el módulo. Si se produce un error en la función, el valor devuelto es NULL.

Parámetros

lpszModuleName

Apunta a una cadena terminada en nulo que contiene el nombre del módulo (ya sea un.DLL o.Archivo EXE). El nombre especificado es el nombre de archivo del módulo.

Si la cadena especifica una ruta de acceso, pero el archivo no existe en el directorio especificado, la función falla.

Si no se especifica una ruta de acceso y se omite la extensión de nombre de archivo, la extensión predeterminada.Se anexa el archivo DLL. Sin embargo, la cadena de nombre de archivo puede incluir un carácter de punto final (.) para indicar que el nombre del módulo no tiene ninguna extensión. Cuando no se ha especificado ninguna ruta, la función busca el archivo en la siguiente secuencia:

• El directorio desde el que se carga la aplicación.
  
  
• El directorio actual.
  
  
• Windows 95: El directorio del sistema Windows. Windows NT: El directorio de sistema de Windows de 32 bits. El nombre de este directorio es SYSTEM32.
  
  
• Sólo Windows NT: El directorio de sistema de Windows de 16 bits. No hay ninguna función de Win32 que obtiene la ruta de acceso de este directorio, sino se busca. El nombre de este directorio es sistema.
  
  
• El directorio de Windows.
  
  
• Los directorios que se enumeran en la variable de entorno PATH.

Observaciones

Utilice AfxLoadLibrary para asignar un módulo DLL. Devuelve un identificador que puede utilizarse en GetProcAddress para obtener la dirección de una función DLL. AfxLoadLibrary también puede utilizarse para asignar otros módulos ejecutables.

Cada proceso mantiene un recuento de referencia para cada módulo de biblioteca cargada. Este recuento de referencias se incrementa cada vez AfxLoadLibrary se llama y se disminuye cada vez que se llama AfxFreeLibrary . Cuando el recuento de referencias llega a cero, el módulo es asignado desde el espacio de direcciones del proceso de llamada y el identificador no es válido.

Asegúrese de utilizar AfxLoadLibrary y AfxFreeLibrary (en lugar de las funciones Win32 LoadLibrary y FreeLibrary) si la aplicación utiliza varios subprocesos. Uso de AfxLoadLibrary y AfxFreeLibrary garantiza que el código de inicio y apagado que se ejecuta cuando se carga y descarga el archivo DLL de extensión no corromper el estado global de MFC.

Vea tambié&nnbsp;AfxFreeLibrary