Функция LoadLibraryShim

  • Статья

Загружает указанную версию библиотеки DLL, которая входит в состав распространяемого пакета платформа .NET Framework.

Эта функция не рекомендуется использовать в платформа .NET Framework 4. Вместо этого используйте метод ICLRRuntimeInfo::LoadLibrary .

Синтаксис

HRESULT LoadLibraryShim (  
    [in]  LPCWSTR  szDllName,  
    [in]  LPCWSTR  szVersion,  
          LPVOID   pvReserved,  
    [out] HMODULE *phModDll  
);

Параметры

szDllName
[in] Строка с нулем, представляющая имя библиотеки DLL, загружаемой из библиотеки платформа .NET Framework.

szVersion
[in] Строка с отсчитывается от нуля, представляющая версию загружаемой библиотеки DLL. Если szVersion имеет значение NULL, то для загрузки выбрана последняя версия указанной библиотеки DLL, которая меньше версии 4. Это значит, что все версии, равные или превышающие версию 4, игнорируются, если szVersion имеет значение NULL, и если не установлена версия ниже версии 4, библиотека DLL не загружается. Это необходимо, чтобы установка платформа .NET Framework 4 не влияла на существующие приложения или компоненты. См. запись In-Proc SxS и Краткое руководство по миграции в блоге команды CLR.

pvReserved
Зарезервировано для последующего использования.

phModDll
[out] Указатель на дескриптор модуля.

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

Этот метод возвращает стандартные коды ошибок МОДЕЛИ COM, как определено в WinError.h, в дополнение к следующим значениям.

Код возврата Описание
S_OK Метод завершился успешно.
CLR_E_SHIM_RUNTIMELOAD Для загрузки szDllName требуется загрузка среды CLR, и необходимая версия среды CLR не может быть загружена.

Комментарии

Эта функция используется для загрузки библиотек DLL, которые входят в состав распространяемого пакета платформа .NET Framework. Он не загружает созданные пользователем библиотеки DLL.

Примечание

Начиная с платформа .NET Framework версии 2.0 загрузка Fusion.dll приводит к загрузке среды CLR. Это связано с тем, что функции в Fusion.dll теперь являются оболочками, реализации которых предоставляются средой выполнения.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

версии платформа .NET Framework: доступно с версии 1.0.

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