Функция 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] CoclassCLSID, реализующий интерфейс ICorRuntimeHost или ICLRRuntimeHost. Поддерживаемые значения : CLSID_CorRuntimeHost или CLSID_CLRRuntimeHost.
riid
[in] Запрашиваемого IID интерфейса. Поддерживаемые значения : IID_ICorRuntimeHost или IID_ICLRRuntimeHost.
ppv
[out] Указатель интерфейса на версию загруженной среды выполнения.
Требования
Платформы: см. раздел Требования к системе.
Заголовок: MSCorEE.idl
Библиотека: MSCorEE.dll
версии платформа .NET Framework: Доступно с версии 1.0
