Megosztás:

CorBindToRuntimeHost függvény

Lehetővé teszi, hogy a gazdagépek betöltse a közös nyelvi futtatókörnyezet (CLR) egy adott verzióját egy folyamatba.

Ez a függvény elavult a .NET-keretrendszer 4-ben.

Syntax

HRESULT CorBindToRuntimeHost (  
    [in] LPCWSTR       pwszVersion,
    [in] LPCWSTR       pwszBuildFlavor,
    [in] LPCWSTR       pwszHostConfigFile,
    [in] VOID*         pReserved,
    [in] DWORD         startupFlags,
    [in] REFCLSID      rclsid,
    [in] REFIID        riid,
    [out] LPVOID FAR  *ppv  
);

Paraméterek

pwszVersion
[in] A betölteni kívánt CLR verzióját leíró sztring.

A .NET-keretrendszer egy verziószáma négy részből áll, amelyeket időszakok választanak el egymástól: major.minor.build.revision. Az átadott pwszVersion sztringnek a "v" karakterrel kell kezdődnie, majd a verziószám első három része (például "v1.0.1529").

A CLR egyes verziói olyan házirend-utasítással vannak telepítve, amely a CLR korábbi verzióival való kompatibilitást határozza meg. Alapértelmezés szerint az indítási shim kiértékeli a szabályzatutasításokat pwszVersion , és betölti a futtatókörnyezet legújabb verzióját, amely kompatibilis a kért verzióval. A gazdagép kényszerítheti a shim-et, hogy hagyja ki a szabályzat kiértékelését, és töltse be a megadott pwszVersion pontos verziót a paraméter STARTUP_LOADER_SAFEMODE startupFlags értékének átadásával.

Ha pwszVersion igen null, a metódus nem tölti be a CLR egyik verzióját sem. Ehelyett CLR_E_SHIM_RUNTIMELOAD ad vissza, ami azt jelzi, hogy nem sikerült betölteni a futtatókörnyezetet.

pwszBuildFlavor
[in] Egy sztring, amely meghatározza, hogy betöltse-e a kiszolgálót vagy a CLR munkaállomás-buildét. Az érvényes értékek a következők: svr és wks. A kiszolgáló buildje úgy van optimalizálva, hogy kihasználja a szemétgyűjtéshez használható processzorok előnyeit, a munkaállomás-build pedig az egyprocesszoros gépen futó ügyfélalkalmazásokhoz van optimalizálva.

Ha pwszBuildFlavor null értékre van állítva, a munkaállomás buildje betöltődik. Ha egyprocesszoros gépen fut, a munkaállomás buildje mindig betöltődik, még akkor is, ha pwszBuildFlavor be van állítva svr. pwszBuildFlavor Ha azonban be van állítva svr és egyidejű szemétgyűjtés van megadva (lásd a startupFlags paraméter leírását), a kiszolgáló buildje betöltődik.

Feljegyzés

Az egyidejű szemétgyűjtés nem támogatott a WOW64 x86 emulátort futtató alkalmazásokban az Intel Itanium architektúrát implementáló 64 bites rendszereken (korábbi nevén IA-64). A WOW64 64 bites Windows-rendszereken való használatáról további információt a 32 bites alkalmazások futtatása című témakörben talál.

pwszHostConfigFile
[in] Egy gazdagépkonfigurációs fájl neve, amely megadja a betöltendő CLR verzióját. Ha a fájlnév nem tartalmaz teljes elérési utat, a rendszer feltételezi, hogy a fájl ugyanabban a könyvtárban van, mint a hívást végrehajtó végrehajtható fájl.

pReserved
[in] A jövőbeli bővíthetőség érdekében fenntartva.

startupFlags
[in] Az egyidejű szemétgyűjtést, a tartománysemleges kódot és a paraméter viselkedését vezérlő jelzők készlete pwszVersion . Az alapértelmezett tartomány egyetlen tartomány, ha nincs beállítva jelölő. A támogatott értékek listáját a STARTUP_FLAGS enumerálásban találja.

rclsid
[in] Az CLSID ICorRuntimeHost vagy az ICLRRuntimeHost felületet megvalósító társosztály. A támogatott értékek CLSID_CorRuntimeHost vagy CLSID_CLRRuntimeHost.

riid
[in] A IID kért felület. A támogatott értékek IID_ICorRuntimeHost vagy IID_ICLRRuntimeHost.

ppv
[kifelé] Egy felületmutató a betöltött futtatókörnyezet verziójára.

Követelmények

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: MSCorEE.idl

Kódtár: MSCorEE.dll

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

Lásd még

  • Last updated on