Método ICLRMetaHost::GetRuntime

Artigo
05/09/2023

Obtém a interface ICLRRuntimeInfo que corresponde a uma versão específica do common language runtime (CLR). Este método substitui a função CorBindToRuntimeEx utilizada com o sinalizador STARTUP_LOADER_SAFEMODE .

Sintaxe

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parâmetros

pwzVersion
[in] A .NET Framework versão de compilação armazenada nos metadados, no formato "vA. B[. X]". A, B e X são números decimais que correspondem à versão principal, à versão secundária e ao número de compilação.

Nota

Este parâmetro tem de corresponder ao nome do diretório da versão .NET Framework, tal como aparece em C:\Windows\Microsoft.NET\Framework ou C:\Windows\Microsoft.NET\Framework64.

Os valores de exemplo são "v1.0.3705", "v1.1.4322", "v2.0.50727" e "v4.0. X", em que X depende do número de compilação instalado. É necessário o prefixo "v".

riid
[in] O identificador da interface pretendida. Atualmente, o único valor válido para este parâmetro é IID_ICLRRuntimeInfo.

ppRuntime
[fora] Um ponteiro para a interface ICLRRuntimeInfo que corresponde ao runtime pedido.

Devolver Valor

Este método devolve os seguintes HRESULTs específicos, bem como erros HRESULT que indicam a falha do método.

HRESULT	Description
S_OK	O método foi concluído com êxito.
E_POINTER	`pwzVersion` ou `ppRuntime` é nulo.

Observações

Este método interage de forma consistente com interfaces legadas, como a interface ICorRuntimeHost e funções legadas, como as funções preteridas CorBindTo* (veja Funções de Alojamento CLR Preteridas na API de alojamento do .NET Framework 2.0). Ou seja, os runtimes carregados com a API legada são visíveis para a nova API e os runtimes carregados com a nova API são visíveis para a API legada.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: MetaHost.h

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

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

Partilhar via