Compartilhar via


ICLRRuntimeInfo::GetInterface Method

Carrega o CLR no processo atual e retorna ponteiros de interface de runtime, como ICLRRuntimeHost, ICLRStrongName e IMetaDataDispenserEx.

Esse método substitui todas as CorBindTofunções * na seção Funções de Hospedagem CLR preteridas .

Syntax

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

Parameters

rclsid [in] A interface CLSID para a coclass.

riid [in] A IID da interface solicitada rclsid .

ppUnk [out] Um ponteiro para a interface consultada.

Return Value

Esse método retorna os HRESULTs específicos a seguir, bem como erros HRESULT que indicam falha de método.

HRESULT Description
S_OK O método foi concluído com êxito.
E_POINTER ppUnk é nulo.
E_OUTOFMEMORY Não há memória suficiente disponível para lidar com a solicitação.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND Um runtime diferente já estava associado à política de ativação clr versão 2 herdada.

Remarks

Esse método faz com que o CLR seja carregado, mas não inicializado.

A tabela a seguir mostra as combinações com suporte para rclsid e 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

Plataformas: confira Requisitos do sistema.

Header: MetaHost.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

Versões do .NET Framework: Disponível desde 4

See also