Interface de ICLRRuntimeHost

  • Artigo

Fornece uma funcionalidade semelhante da ICorRuntimeHost interface fornecida na.NET Framework versão 1, com as seguintes alterações:

  • A adição de SetHostControl método para definir a interface de controle de host.

  • A omissão de alguns métodos fornecidos pelo ICorRuntimeHost.

Métodos

Método

Descrição

Método de ICLRRuntimeHost::ExecuteApplication

Usado em cenários de implantação ClickOnce baseada em manifesto para especificar o aplicativo a ser ativada em um novo domínio.

Método de ICLRRuntimeHost::ExecuteInAppDomain

Especifica o AppDomain para executar o código gerenciado especificado.

Método de ICLRRuntimeHost::ExecuteInDefaultAppDomain

Chama o método especificado do tipo especificado no assembly especificado.

Método de ICLRRuntimeHost::GetCLRControl

Obtém um ponteiro de interface do tipo ICLRControl que os hosts podem usar para personalizar aspectos do common language runtime (CLR).

Método de ICLRRuntimeHost::GetCurrentAppDomainId

Obtém o identificador numérico da AppDomain que está sendo executado.

Método de ICLRRuntimeHost::SetHostControl

Define a interface de controle de host. Você deve chamar SetHostControl antes de chamar Start.

Método de ICLRRuntimeHost::Start

Inicializa o CLR em um processo.

Método de ICLRRuntimeHost::Stop

Interrompe a execução de código em tempo de execução.

Método de ICLRRuntimeHost::UnloadAppDomain

Descarrega a AppDomain que corresponde a um identificador numérico especificado.

Comentários

Começando com o .NET Framework versão 4, use o ICLRMetaHost interface para obter um ponteiro para o ICLRRuntimeInfo interface e, em seguida, chame o ICLRRuntimeInfo::GetInterface método para obter um ponteiro para ICLRRuntimeHost. Em versões anteriores do.NET Framework, o host obtém um ponteiro para uma ICLRRuntimeHost instância chamando CorBindToRuntimeEx ou CorBindToCurrentRuntime. Forneça implementações de qualquer uma das tecnologias fornecidas na.NET Framework versão 2.0, você deve usar ICLRRuntimeHost em vez de ICorRuntimeHost.

Observação importanteImportante

Não chame o Iniciar método antes de chamar o ExecuteApplication método para ativar um aplicativo baseado no manifesto.Se a Start método é chamado pela primeira vez, o ExecuteApplication chamada de método irá falhar.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Função de CorBindToCurrentRuntime

Função de CorBindToRuntimeEx

Interface de ICLRControl

Interface de ICorRuntimeHost

Coclass de CLRRuntimeHost

Conceitos

Visão geral de hospedagem.

Outros recursos

Interfaces de hospedagem.

Histórico de alterações

Date

History

Motivo

Junho de 2010

Corrigido as instruções para obter um ponteiro para a interface.

Correção de bug de conteúdo.