Функция CorBindToRuntimeHost

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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 состоит из четырех частей, отделенных друг от друга точками: основной.дополнительный.построение.редакция. Строка, передаваемая в виде параметра pwszVersion, должна начинаться со знака v, за которым следуют первые три части номера версии (например, v1.0.1529).

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

Если вызывающий объект задал для параметра pwszVersion значение NULL, загружается последняя версия среды CLR. Значение NULL не позволяет основному приложению указывать версию среды выполнения, которую необходимо загрузить. Хотя в некоторых сценариях этот подход может быть приемлемым, настоятельно рекомендуется точно указывать версию для загрузки.

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

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

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

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

pwszHostConfigFile
[in] Имя файла конфигурации основного приложения, задающего версию загружаемой среды CLR. Если имя файла не включает полный путь, предполагается, что файл находится в том же каталоге, что и вызывающий исполняемый файл.
pReserved
[in] Зарезервирован для будущего расширения.
startupFlags
[in] Коллекция флагов, управляющих параллельной сборкой мусора, независящим от домена кодом и поведением параметра pwszVersion. Если флаги не установлены, по умолчанию используется один домен. Поддерживаются следующие значения:
- STARTUP_CONCURRENT_GC. Задает использование параллельной сборки мусора. Если вызывающий объект запрашивает построение сервера и задает параллельную сборку мусора на однопроцессорном компьютере, то все равно запускается построение рабочей станции и непараллельная сборка мусора.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN. Указывает, что ни одна из сборок не загружается как не зависящая от домена.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN. Указывает, что все сборки загружаются как не зависящая от домена.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST. Указывает, что все строго именованные сборки загружаются как не зависящая от домена.
- STARTUP_LOADER_SAFEMODE. Указывает, что будет загружена точно заданная версия среды CLR, переданная в параметре pwszVersion. Оболочка совместимости не определяет по политике последнюю совместимую версию.
rclsid
[in] Идентификатор CLSID компонентного класса, реализующего искомый интерфейс. Поддерживаемые значения: CLSID_CorRuntimeHost или NULL.
riid
[in] Идентификатор IID запрашиваемого интерфейса. Для исходного выпуска среды выполнения поддерживаются значения IID_ICorRuntimeHost и NULL.
ppv
[out] Указатель интерфейса на версию загруженной среды выполнения.