Partilhar via

ICLRMetaHost Interface

  • Artigo

Fornece métodos que devolvem uma versão específica do runtime de linguagem comum (CLR) com base no respetivo número de versão, listam todos os CLRs instalados, listam todos os runtimes carregados num processo especificado, descobrem a versão CLR utilizada para compilar uma assemblagem, saem de um processo com um encerramento de tempo de execução limpo e consultam o enlace da API legada.

Métodos

Método Descrição
EnumerateInstalledRuntimes Method Devolve uma enumeração que contém um ponteiro de interface ICLRRuntimeInfo válido para cada versão CLR instalada num computador.
EnumerateLoadedRuntimes Method Devolve uma enumeração que contém um ponteiro de interface ICLRRuntimeInfo válido para cada CLR carregado num determinado processo. Este método substitui GetVersionFromProcess.
Método ExitProcess Tenta encerrar todos os runtimes carregados corretamente e, em seguida, termina o processo. Substitui a função CorExitProcess .
Método GetRuntime Obtém a interface ICLRRuntimeInfo que corresponde a uma versão clR específica. Este método substitui a função CorBindToRuntimeEx utilizada com o sinalizador STARTUP_LOADER_SAFEMODE .
Método GetVersionFromFile Obtém a versão original de compilação de .NET Framework da assemblagem (armazenada nos metadados), dado o respetivo caminho de ficheiro. Este método substitui GetFileVersion.
Método QueryLegacyV2RuntimeBinding Devolve uma interface que representa um runtime ao qual a política de ativação legada foi vinculada, por exemplo, ao utilizar o useLegacyV2RuntimeActivationPolicy atributo na <entrada de ficheiro de configuração do Elemento de arranque>, através da utilização direta das APIs de ativação legadas ou ao chamar o método ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Método RequestRuntimeLoadedNotification Garante uma chamada de retorno para o ponteiro de função especificado quando uma versão CLR é carregada pela primeira vez, mas ainda não foi iniciada. Este método substitui LockClrVersion

Observações

A única forma de obter uma instância desta interface é ao chamar a função CLRCreateInstance da seguinte forma:

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

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MetaHost.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 4

Ver também