Partilhar via

ICLRMetaHost Interface

Fornece métodos que retornam uma versão específica do runtime da common language (CLR) com base no seu número de versão, listam todos os CLRs instalados, listam todos os runtimes carregados num processo especificado, descobrem a versão CLR usada para compilar um assembly, saem de um processo com um desligamento limpo em tempo de execução e consultam a ligação de API legada.

Methods

Método Description
Método EnumerateInstalledRuntimes Devolve uma enumeração que contém um ponteiro válido da interface ICLRRuntimeInfo para cada versão do CLR instalada num computador.
Método EnumerateLoadedRuntimes Devolve uma enumeração que contém um ponteiro válido da interface ICLRRuntimeInfo para cada CLR carregado num dado processo. Este método substitui o GetVersionFromProcess.
ExitProcess Método Tenta desligar todos os tempos de execução carregados de forma elegante e depois termina o processo. Substitui a função CorExitProcess .
Método GetRuntime Recebe a interface ICLRRuntimeInfo que corresponde a uma versão específica do CLR. Este método substitui a função CorBindToRuntimeEx usada com a STARTUP_LOADER_SAFEMODE flag.
Método GetVersionFromFile Obtém a versão original da compilação .NET Framework do assembly (armazenada nos metadados), dado o caminho do ficheiro. Este método substitui o GetFileVersion.
QueryLegacyV2RuntimeBinding Method Devolve uma interface que representa um runtime ao qual a política de ativação legada foi vinculada, por exemplo, usando o useLegacyV2RuntimeActivationPolicy atributo na <startup> entrada do ficheiro de configuração Element, usando diretamente as APIs de ativação legadas, ou chamando o método ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Método RequestRuntimeLoadedNotification Garante uma chamada de retorno ao ponteiro de função especificado quando uma versão CLR é carregada pela primeira vez, mas ainda não iniciada. Este método substitui o LockClrVersion

Observações

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

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

Requerimentos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: MetaHost.h

Biblioteca: Incluído como recurso em MSCorEE.dll

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

Consulte também

  • Last updated on