Partilhar via


ICLRRuntimeInfo::GetInterface Method

Carrega o CLR no processo atual e retorna ponteiros de interface de tempo de execução, 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 [em] A interface CLSID para a coclass.

riid [em] O IID da interface solicitada rclsid .

ppUnk [saídas] Um ponteiro para a interface consultada.

Return Value

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha do método.

HRESULT Description
S_OK O método foi concluído com êxito.
E_POINTER ppUnk é null.
E_OUTOFMEMORY Não há memória suficiente disponível para lidar com a solicitação.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND Um tempo de execução diferente já estava vinculado à política de ativação do 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 suportadas 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: Consulte Requisitos do sistema.

Header: MetaHost.h

Biblioteca: Incluído como recurso no MSCorEE.dll

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

See also