Interface ICLRRuntimeHost
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
