ICLRRuntimeInfo::GetInterface Method

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

Этот метод заменяет все CorBindToфункции * в разделе "Нерекомендуемые функции размещения среды CLR ".

Syntax

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

Parameters

rclsid [in] Интерфейс CLSID для coclass.

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

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

Return Value

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

HRESULT	Description
S_OK	Метод успешно завершен.
E_POINTER	ppUnk имеет значение NULL.
E_OUTOFMEMORY	Недостаточно памяти для обработки запроса.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND	Другая среда выполнения уже привязана к устаревшей политике активации среды CLR версии 2.

Remarks

Этот метод приводит к загрузке среды 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_CLRDebuggingLegacy	IID_ICorDebug
CLSID_CLRStrongName	IID_ICLRStrongName

Requirements

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

Header: MetaHost.h

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

Версии .NET Framework: Доступно с 4

See also

• ICLRRuntimeInfo Interface
• Hosting Interfaces
• Hosting