Método de ICLRMetaHost::GetRuntime

Artigo
08/08/2011

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

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 armazenado nos metadados, no formato "va.B.X". A, b, e x são números decimais que correspondem a versão principal, a versão secundária e o número de compilação.

Observação

Este parâmetro deve corresponder ao nome do diretório para o.NET Framework versão como ele aparece sob C:\Windows\Microsoft.NET\Framework ou C:\Windows\Microsoft.NET\Framework64.

Os valores de exemplo são "v 1.0.3705", "v 1.1.4322", "v2.0.50727" e "v 4.0.x", onde x depende do número de compilação instalado. O "v" é necessário um prefixo.
riid
[in] O identificador de interface desejado. Atualmente, o único valor válido para esse parâmetro é IID_ICLRRuntimeInfo.
ppRuntime
[out] Um ponteiro para o ICLRRuntimeInfo interface que corresponde ao tempo de execução solicitado.

Valor de retorno

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

HRESULT	Descrição
S_OK	O método foi concluído com êxito.
E_POINTER	pwzVersionou ppRuntime é null.

Comentários

Esse método consistentemente interage com interfaces herdados, como o ICorRuntimeHost funções de interface e legados como, por exemplo, o preterido CorBindTo* funções (consulte .NET Framework 1.1 e 2.0, hospedagem Global de funções estáticas na.NET Framework 2.0 API de hospedagem). Ou seja, runtimes são carregadas com a API herdada são visíveis para a nova API e tempos de execução são carregados com a nova API são visíveis para a API herdada. .