Función CoLoadLibrary (objbase.h)

Carga un archivo DLL específico en el proceso del autor de la llamada.

CoLoadLibrary es equivalente a LoadLibraryEx. CoLoadLibrary no afecta a la duración de la biblioteca.

Sintaxis

HINSTANCE CoLoadLibrary(
  [in] LPOLESTR lpszLibName,
  [in] BOOL     bAutoFree
);

Parámetros

[in] lpszLibName

Nombre de la biblioteca que se va a cargar.

[in] bAutoFree

Este parámetro se mantiene por compatibilidad con aplicaciones de 16 bits, pero se omite.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador de la biblioteca cargada; de lo contrario, es NULL.

Comentarios

La función CoGetClassObject no llama a CoLoadLibrary. CoLoadLibrary carga un archivo DLL especificado por el parámetro lpszLibName en el proceso que llamó a CoGetClassObject. Los contenedores no deben llamar directamente a CoLoadLibrary .

Internamente, se mantiene un recuento de referencias en el archivo DLL cargado mediante CoLoadLibrary para incrementar el recuento y la función CoFreeLibrary para disminuirlo.

Requisitos

Consulte también

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx