ICLRMetaHost::GetRuntime metódus

Lekéri a közös nyelvi futtatókörnyezet (CLR) egy adott verziójának megfelelő ICLRRuntimeInfo felületet. Ez a metódus felülírja a STARTUP_LOADER_SAFEMODE jelzővel használt CorBindToRuntimeEx függvényt.

Szintaxis

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

Paraméterek

pwzVersion
[in] A metaadatokban tárolt .NET-keretrendszer fordítási verzió "vA" formátumban. B[. X]". Az A, B és X tizedes törtszámok, amelyek a főverziónak, az alverziónak és a buildszámnak felelnek meg.

Megjegyzés

Ennek a paraméternek meg kell egyeznie a .NET-keretrendszer-verzió könyvtárnevével, ahogy az a C:\Windows\Microsoft.NET\Framework vagy C:\Windows\Microsoft.NET\Framework64 alatt látható.

Példaértékek: "v1.0.3705", "v1.1.4322", "v2.0.50727" és "v4.0. X", ahol az X a telepített buildszámtól függ. A "v" előtag megadása kötelező.

riid
[in] A kívánt felület azonosítója. Jelenleg a paraméter egyetlen érvényes értéke a IID_ICLRRuntimeInfo.

ppRuntime
[kifelé] Mutató a kért futtatókörnyezetnek megfelelő ICLRRuntimeInfo felületre.

Visszatérési érték

Ez a metódus a következő konkrét HRESULT-okat, valamint a metódushibát jelző HRESULT-hibákat adja vissza.

HRESULT Description
S_OK A metódus sikeresen befejeződött.
E_POINTER pwzVersion vagy ppRuntime null értékű.

Megjegyzések

Ez a módszer következetesen együttműködik az örökölt felületekkel, például az ICorRuntimeHost felülettel és az olyan örökölt függvényekkel, mint az elavult CorBindTo* függvények (lásd: Elavult CLR hosting functions in the .NET-keretrendszer 2.0 hosting API). Ez azt jelzi, hogy az örökölt API-val betöltött futtatókörnyezetek láthatók az új API-nak, az új API-val betöltött futtatókörnyezetek pedig az örökölt API-nak.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MetaHost.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 4 óta érhető el

Lásd még

  • Last updated on