Método de ICLRRuntimeInfo::GetInterface

Carrega o CLR no processo atual e retorna o tempo de execução ponteiros de interface, como ICLRRuntimeHost, ICLRStrongName, e IMetaDataDispenser.

Este método substitui todas as CorBindTo* funciona na .NET Framework 1.1 e 2.0, hospedagem Global de funções estáticas seção.

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

Parâmetros

  • rclsid
    [in] A interface do CLSID para o coclass.

  • riid
    [in] O IID dos solicitados rclsid interface.

  • ppUnk
    [out] Um ponteiro para a interface consultado.

Valor de retorno

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

HRESULT

Descrição

S_OK

O método foi concluído com êxito.

E_POINTER

ppUnké nulo.

E_OUTOFMEMORY

Não há memória suficiente está disponível para manipular a solicitação.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

Um tempo de execução diferente já era ligado a política de ativação 2 versão CLR herdados.

Comentários

Este método faz com que o CLR a ser 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_CLRStrongName

IID_ICLRStrongName

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MetaHost.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4

Consulte também

Referência

Interface de ICLRRuntimeInfo

Outros recursos

Interfaces de hospedagem.

Hospedagem (referência de API não gerenciada)

Histórico de alterações

Date

History

Motivo

Outubro de 2010

Adicionado CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND para códigos de retorno.

Correção de bug de conteúdo.

Setembro de 2010

Corrigida a vários riid entradas.

Comentários do cliente.

Junho de 2010

Corrigido o riid que podem ser usados em combinação com CLSID_CLRRuntimeHost.

Correção de bug de conteúdo.