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

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	objbase.h
Library	Ole32.lib
Archivo DLL	Ole32.dll
Conjunto de API	ext-ms-win-com-ole32-l1-1-5 (introducido en Windows 10, versión 10.0.15063)

Consulte también

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx