Método de ICLRMetaHost::GetRuntime

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. .

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MetaHost.h

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4

Consulte também

Referência

Interface de ICLRMetaHost

Outros recursos

.NET Framework 1.0 e 1.1 Interfaces hospedagem

.NET Framework 2.0 Interfaces de hospedagem

.NET Framework 1.1 e 2.0, hospedagem Global de funções estáticas

Hospedagem (referência de API não gerenciada)