Interface de ICLRRuntimeHost

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.

Importante
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.