Функция CorBindToRuntimeHost

  • Статья

Позволяет узлам загружать указанную версию среды CLR в процесс.

Эта функция устарела в платформа .NET Framework 4.

Синтаксис

HRESULT CorBindToRuntimeHost (  
    [in] LPCWSTR       pwszVersion,
    [in] LPCWSTR       pwszBuildFlavor,
    [in] LPCWSTR       pwszHostConfigFile,
    [in] VOID*         pReserved,
    [in] DWORD         startupFlags,
    [in] REFCLSID      rclsid,
    [in] REFIID        riid,
    [out] LPVOID FAR  *ppv  
);

Параметры

pwszVersion
[in] Строка, описывающая версию среды CLR, которую требуется загрузить.

Номер версии в платформа .NET Framework состоит из четырех частей, разделенных точками: major.minor.build.revision. Строка, передаваемая как pwszVersion , должна начинаться с символа v, за которым следует первые три части номера версии (например, "v1.0.1529").

Некоторые версии среды CLR устанавливаются с помощью инструкции политики, указывающей совместимость с предыдущими версиями среды CLR. По умолчанию оболочка запуска оценивается pwszVersion по инструкциям политики и загружает последнюю версию среды выполнения, совместимую с запрашиваемой версией. Узел может заставить оболочку пропустить оценку политики и загрузить точную версию, указанную в , pwszVersion передав значение STARTUP_LOADER_SAFEMODE для startupFlags параметра .

Если pwszVersion параметр является , null, метод не загружает ни одну версию среды CLR. Вместо этого он возвращает CLR_E_SHIM_RUNTIMELOAD, что означает, что не удалось загрузить среду выполнения.

pwszBuildFlavor
[in] Строка, указывающая, следует ли загрузить сервер или сборку рабочей станции среды CLR. Допустимые значения: svr и wks. Сборка сервера оптимизирована для использования нескольких процессоров для сборки мусора, а сборка рабочей станции оптимизирована для клиентских приложений, работающих на компьютере с одним процессором.

Если pwszBuildFlavor задано значение NULL, загружается сборка рабочей станции. При запуске на компьютере с одним процессором сборка рабочей станции всегда загружается, даже если pwszBuildFlavor для задано значение svr. Однако если pwszBuildFlavor задано значение svr и указана параллельная сборка мусора (см. описание startupFlags параметра), сборка сервера загружается.

Примечание

Параллельная сборка мусора не поддерживается в приложениях, работающих с эмулятором WOW64 x86 в 64-разрядных системах, реализующих архитектуру Intel Itanium (прежнее название — IA-64). Дополнительные сведения об использовании WOW64 в 64-разрядных системах Windows см. в статье Запуск 32-разрядных приложений.

pwszHostConfigFile
[in] Имя файла конфигурации узла, указывающее версию среды CLR для загрузки. Если имя файла не содержит полный путь, предполагается, что файл находится в том же каталоге, что и исполняемый файл, выполняющий вызов .

pReserved
[in] Зарезервировано для будущей расширяемости.

startupFlags
[in] Набор флагов, который управляет параллельной сборкой мусора, не зависящим от домена кодом и поведением pwszVersion параметра. По умолчанию используется один домен, если флаг не установлен. Список поддерживаемых значений см. в перечислении STARTUP_FLAGS.

rclsid
[in] Класс CLSID сокласса, реализующий интерфейс ICorRuntimeHost или ICLRRuntimeHost . Поддерживаются значения CLSID_CorRuntimeHost или CLSID_CLRRuntimeHost.

riid
[in] Объект IID запрашиваемого интерфейса. Поддерживаются значения IID_ICorRuntimeHost или IID_ICLRRuntimeHost.

ppv
[out] Указатель интерфейса на версию загруженной среды выполнения.

Требования

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

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

Библиотека: MSCorEE.dll

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

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