Interface de ICLRMetaHost

Artigo
08/08/2011

Fornece métodos que retornam uma versão específica do common language runtime (CLR) com base em seu número de versão, listam todos os CLRs instalados, listam de todos os tempos de execução que são carregados em um processo especificado, descubram a versão do CLR usada para compilar um assembly, sair de um processo com um runtime limpo de desligamento e ligação herdada de API de consulta.

Métodos

Método	Descrição
Método de ICLRMetaHost::EnumerateInstalledRuntimes	Retorna uma enumeração que contém um válido ICLRRuntimeInfo o ponteiro de interface para cada versão CLR que está instalado em um computador.
Método de ICLRMetaHost::EnumerateLoadedRuntimes	Retorna uma enumeração que contém um válido ICLRRuntimeInfo o ponteiro de interface para cada CLR que é carregado em um determinado processo. Este método substitui GetVersionFromProcess.
Método de ICLRMetaHost::ExitProcess	Tenta desligar carregados de todos os tempos de execução normalmente e, em seguida, encerra o processo. Substitui o CorExitProcess função.
Método de ICLRMetaHost::GetRuntime	Obtém o ICLRRuntimeInfo interface que corresponde a uma versão específica do CLR. Este método substitui a CorBindToRuntimeEx função usada com o STARTUP_LOADER_SAFEMODE sinalizador.
Método de ICLRMetaHost::GetVersionFromFile	Obtém o original do assembly.NET Framework compilação versão (armazenada nos metadados), dado seu caminho de arquivo. Este método substitui GetFileVersion.
Método de ICLRMetaHost::QueryLegacyV2RuntimeBinding	Retorna uma interface que representa um tempo de execução para o qual diretiva legado de ativação foi vinculada, por exemplo, usando o useLegacyV2RuntimeActivationPolicy de atributo na <startup> Elemento entrada do arquivo de configuração, pelo uso direto da ativação herdado APIs ou chamando o ICLRRuntimeInfo::BindAsLegacyV2Runtime método.
Método de ICLRMetaHost::RequestRuntimeLoadedNotification	Garante um retorno de chamada para o ponteiro de função especificado quando uma versão do CLR é carregada pela primeira vez, mas ainda não foi iniciada. Este método substitui LockClrVersion

Comentários

A única maneira de obter uma instância desta interface é chamando o CLRCreateInstance funciona da seguinte maneira:

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

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

Outros recursos

Interfaces de hospedagem.

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

Histórico de alterações

Date	History	Motivo
Setembro de 2010	Corrigido IID na listagem de código.	Comentários do cliente.

Setembro de 2010

Corrigido IID na listagem de código.

Comentários do cliente.

Compartilhar via