Поделиться через

Метод ICLRRuntimeInfo::GetInterface

  • Статья

Загружает среду CLR в текущий процесс и возвращает указатели на интерфейсы среды выполнения, такие как ICLRRuntimeHost, ICLRStrongName и IMetaDataDispenser.

Этот метод заменяет все функции CorBindTo* в разделе Глобальные статические функции платформ .NET Framework 1.1 и 2.0.

HRESULT GetInterface(
[in]  REFCLSID rclsid,
[in]  REFIID   riid,
[out, iid_is(riid), retval] LPVOID *ppUnk);

Параметры

  • rclsid
    [in] Интерфейс CLSID для компонентного класса.

  • riid
    [in] Идентификатор IID запрошенного интерфейса rclsid.

  • ppUnk
    [out] Указатель на запрошенный интерфейс.

Возвращаемое значение

Этот метод возвращает следующие заданные HRESULT, а также ошибки HRESULT, которые указывают на сбой метода.

HRESULT

Описание

S_OK

Метод успешно выполнен.

E_POINTER

Параметр ppUnk имеет значение NULL.

E_OUTOFMEMORY

Недостаточно памяти для обработки запроса.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

Другая среда выполнения уже была привязана к устаревшей политике активации версии 2 среды CLR.

Заметки

Этот метод вызывает загрузку среды CLR, но не ее инициализацию.

В следующей таблице приведены поддерживаемые комбинации для параметров rclsid и riid.

rclsid

riid

CLSID_CorMetaDataDispenser

IID_IMetaDataDispenser, IID_IMetaDataDispenserEx

CLSID_CorMetaDataDispenserRuntime

IID_IMetaDataDispenser, IID_IMetaDataDispenserEx

CLSID_CorRuntimeHost

IID_ICorRuntimeHost

CLSID_CLRRuntimeHost

IID_ICLRRuntimeHost

CLSID_TypeNameFactory

IID_ITypeNameFactory

CLSID_CLRStrongName

IID_ICLRStrongName

Требования

Платформы: см. раздел Требования к системе для .NET Framework.

Заголовок: MetaHost.h

Библиотека: включена как ресурс в MSCorEE.dll

Версии платформы .NET Framework: 4

См. также

Ссылки

Интерфейс ICLRRuntimeInfo

Другие ресурсы

Интерфейсы размещения

Размещение (справочник по неуправляемым интерфейсам API)

Журнал изменений

Дата

Журнал

Причина

Октябрь 2010

Добавлен код возврата CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND.

Исправление ошибки содержимого.

Сентябрь 2010

Исправлено несколько записей riid.

Обратная связь от клиента.

Июнь 2010

Исправлен параметр riid, который может использоваться в сочетании с CLSID_CLRRuntimeHost.

Исправление ошибки содержимого.