Метод ICLRMetaHost::GetRuntime
Возвращает интерфейс ICLRRuntimeInfo , соответствующий определенной версии среды CLR. Этот метод заменяет функцию CorBindToRuntimeEx , используемую с флагом STARTUP_LOADER_SAFEMODE .
Синтаксис
HRESULT GetRuntime (
[in] LPCWSTR pwzVersion,
[in] REFIID riid,
[out,iid_is(riid), retval] LPVOID *ppRuntime
);
Параметры
pwzVersion
[in] Версия платформа .NET Framework компиляции, хранящейся в метаданных, в формате "vA. Б[. X]". A, B и X — это десятичные числа, соответствующие основной версии, дополнительной версии и номеру сборки.
Примечание
Этот параметр должен совпадать с именем каталога для версии платформа .NET Framework, так как он отображается в папке C:\Windows\Microsoft.NET\Framework или C:\Windows\Microsoft.NET\Framework64.
Примеры значений: "v1.0.3705", "v1.1.4322", "v2.0.50727" и "v4.0. X", где X зависит от установленного номера сборки. Требуется префикс "v".
riid
[in] Идентификатор нужного интерфейса. В настоящее время единственным допустимым значением этого параметра является IID_ICLRRuntimeInfo.
ppRuntime
[out] Указатель на интерфейс ICLRRuntimeInfo , соответствующий запрошенной среде выполнения.
Возвращаемое значение
Этот метод возвращает следующие конкретные результаты HRESULT, а также ошибки HRESULT, которые указывают на сбой метода.
| HRESULT | Описание: |
|---|---|
| S_OK | Метод завершился успешно. |
| E_POINTER | pwzVersion или ppRuntime равно null. |
Комментарии
Этот метод взаимодействует согласованно с устаревшими интерфейсами, такими как интерфейс ICorRuntimeHost, и устаревшими функциями, такими как устаревшие CorBindTo* функции (см. раздел Устаревшие функции размещения CLR в API размещения платформа .NET Framework 2.0). То есть среды выполнения, загруженные с помощью устаревшего API, видны новому API, а среды выполнения, загруженные с помощью нового API, видны устаревшей версии API.
Требования
Платформы: см. раздел Требования к системе.
Заголовка: MetaHost.h
Библиотека: Включается в качестве ресурса в MSCorEE.dll
версии платформа .NET Framework: доступно с 4
