Método ICLRMetaHost::GetRuntime

Artigo
05/10/2023

Obtém a interface ICLRRuntimeInfo que corresponde a uma versão específica do CLR (Common Language Runtime). Esse método substitui a função CorBindToRuntimeEx usada 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
[out] A versão de compilação do .NET Framework 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 build.

Observação

Esse parâmetro deve corresponder ao nome do diretório da versão do .NET Framework, conforme mostrado em C:\Windows\Microsoft.NET\Framework ou em 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 build instalado. O prefixo "v" é necessário.

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

ppRuntime
[out] Um ponteiro para a interface ICLRRuntimeInfo que corresponde ao runtime solicitado.

Valor Retornado

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha de método.

HRESULT	Descrição
S_OK	O método foi concluído com sucesso.
E_POINTER	`pwzVersion` ou `ppRuntime` é nulo.

Comentários

Esse método interage consistentemente com interfaces herdadas, como a ICorRuntimeHost, e com funções herdadas, como as funções preteridas CorBindTo* (confira Funções de hospedagem do CLR preteridas na API de hospedagem do .NET Framework 2.0). Isso significa que os runtimes carregados com a API herdada ficam visíveis para a nova API e aqueles carregados com a nova API ficam visíveis para a herdada.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 4

Compartilhar via