Compartilhar via

ICLRMetaHost Interface

Fornece métodos que retornam uma versão específica do CLR (Common Language Runtime) com base em seu número de versão, listam todos os CLRs instalados, listam todos os runtimes carregados em um processo especificado, descobrem a versão CLR usada para compilar um assembly, saem de um processo com um desligamento de runtime limpo e consultam a associação de API herdada.

Methods

Método Description
Método EnumerateInstalledRuntimes Retorna uma enumeração que contém um ponteiro de interface ICLRRuntimeInfo válido para cada versão CLR instalada em um computador.
Método EnumerateLoadedRuntimes Retorna uma enumeração que contém um ponteiro de interface ICLRRuntimeInfo válido para cada CLR carregado em um determinado processo. Esse método substitui GetVersionFromProcess.
Método ExitProcess Tenta desligar todos os runtimes carregados normalmente e, em seguida, encerra o processo. Substitui a função CorExitProcess .
Método GetRuntime Obtém a interface ICLRRuntimeInfo que corresponde a uma versão clr específica. Esse método substitui a função CorBindToRuntimeEx usada com o sinalizador STARTUP_LOADER_SAFEMODE .
Método GetVersionFromFile Obtém a versão de compilação original do .NET Framework do assembly (armazenada nos metadados), dado o caminho do arquivo. Esse método substitui GetFileVersion.
Método QueryLegacyV2RuntimeBinding Retorna uma interface que representa um runtime ao qual a política de ativação herdada foi associada, por exemplo, usando o useLegacyV2RuntimeActivationPolicy atributo na <startup> entrada de arquivo de configuração de elemento, usando diretamente as APIs de ativação herdadas ou chamando o método ICLRRuntimeInfo::BindAsLegacyV2Runtime.
Método RequestRuntimeLoadedNotification Garante um retorno de chamada para o ponteiro de função especificado quando uma versão CLR é carregada pela primeira vez, mas ainda não iniciada. Esse método substitui LockClrVersion

Observações

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

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

Requirements

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

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

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

Consulte também

  • Last updated on