Функция CoLoadLibrary (objbase.h)
Загружает определенную библиотеку 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) |