ICLRMetaHost::GetRuntime – metoda

Článek
05/10/2023

Získá ICLRRuntimeInfo rozhraní, které odpovídá konkrétní verzi common language runtime (CLR). Tato metoda nahrazuje funkci CorBindToRuntimeEx použitou s příznakem STARTUP_LOADER_SAFEMODE .

Syntaxe

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

Parametry

pwzVersion
[v] Verze kompilace rozhraní .NET Framework uložená v metadatech ve formátu "vA. B[. X]". A, B a X jsou desetinná čísla, která odpovídají hlavní verzi, podverzi a číslu buildu.

Poznámka

Tento parametr musí odpovídat názvu adresáře pro verzi rozhraní .NET Framework, jak se zobrazuje ve složce C:\Windows\Microsoft.NET\Framework nebo C:\Windows\Microsoft.NET\Framework64.

Příklady hodnot jsou "v1.0.3705", "v1.1.4322", "v2.0.50727" a "v4.0. X", kde X závisí na čísle nainstalovaného buildu. Předpona "v" je povinná.

riid
[v] Identifikátor požadovaného rozhraní. V současné době je jedinou platnou hodnotou tohoto parametru IID_ICLRRuntimeInfo.

ppRuntime
[out] Ukazatel na rozhraní ICLRRuntimeInfo , které odpovídá požadovanému modulu runtime.

Návratová hodnota

Tato metoda vrátí následující konkrétní hodnoty HRESULT a také chyby HRESULT, které značí selhání metody.

HRESULT	Description
S_OK	Metoda byla úspěšně dokončena.
E_POINTER	`pwzVersion` nebo `ppRuntime` má hodnotu null.

Poznámky

Tato metoda konzistentně komunikuje se staršími rozhraními, jako je rozhraní ICorRuntimeHost , a staršími funkcemi, jako jsou zastaralé CorBindTo* funkce (viz Zastaralé funkce hostování MODULUR v rozhraní API pro hostování rozhraní .NET Framework 2.0). To znamená, že moduly runtime načtené se starší verzí rozhraní API jsou viditelné pro nové rozhraní API a moduly runtime načtené s novým rozhraním API jsou viditelné pro starší rozhraní API.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MetaHost.h

Knihovny: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od 4

Sdílet prostřednictvím