Метод ICLRMetaHost::GetRuntime

Статья
08/11/2011

Получает интерфейс 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.B[.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* (см. Глобальные статические функции платформ .NET Framework 1.1 и 2.0 в API размещения .NET Framework 2.0). То есть среды выполнения, загруженные со старым API, являются видимыми для нового API, а среды выполнения, загруженные с новым API, являются видимыми для старого API. .