Share via

Метод 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

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