Interface ICLRRuntimeHost

  • Artigo

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

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

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

Métodos

Método Descrição
Método ExecuteApplication Usado em cenários de implantação ClickOnce baseados em manifesto para especificar o aplicativo a ser ativado em um novo domínio.
Método ExecuteInAppDomain Especifica o AppDomain no qual deve ser executado o código gerenciado especificado.
Método ExecuteInDefaultAppDomain Invoca o método especificado do tipo especificado no assembly especificado.
Método GetCLRControl Obtém um ponteiro de interface do tipo ICLRControl que os hosts podem usar para personalizar aspectos do CLR (Common Language Runtime).
Método GetCurrentAppDomainId Obtém o identificador numérico do AppDomain que está sendo executado no momento.
Método SetHostControl Define a interface de controle do host. É necessário chamar SetHostControl antes de chamar Start.
Método Start Inicializa o CLR em um processo.
Método Stop Interrompe a execução do código pelo runtime.
Método UnloadAppDomain Descarrega AppDomain, que corresponde ao identificador numérico especificado.

Comentários

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

Importante

Não chame o método Start antes de chamar o método ExecuteApplication para ativar um aplicativo baseado em manifesto. Se o método Start for chamado primeiro, a chamada do método ExecuteApplication falhará.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 2.0

Confira também