Функция CoLoadLibrary (objbase.h)

Статья
08/25/2023

Загружает определенную библиотеку DLL в процесс вызывающего.

CoLoadLibrary эквивалентен LoadLibraryEx. CoLoadLibrary не влияет на время существования библиотеки.

Синтаксис

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

Параметры

[in] lpszLibName

Имя загружаемой библиотеки.

[in] bAutoFree

Этот параметр поддерживается для обеспечения совместимости с 16-разрядными приложениями, но игнорируется.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для загруженной библиотеки; В противном случае значение равно NULL.

Функция CoGetClassObject не вызывает CoLoadLibrary. CoLoadLibrary загружает библиотеку DLL, указанную параметром lpszLibName , в процесс, который вызвал CoGetClassObject. Контейнеры не должны вызывать CoLoadLibrary напрямую.

Внутренне количество ссылок сохраняется в загруженной библиотеке DLL с помощью CoLoadLibrary для увеличения числа и функции CoFreeLibrary для его уменьшения.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	objbase.h
Библиотека	Ole32.lib
DLL	Ole32.dll
Набор API	ext-ms-win-com-ole32-l1-1-5 (появилось в Windows 10 версии 10.0.15063)

См. также раздел

CoFreeAllLibraries

CoFreeLibrary

CoFreeUnusedLibraries

CoFreeUnusedLibrariesEx

Поделиться через