Megosztás a következőn keresztül:

CorBindToRuntimeHost függvény

  • Cikk

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.

Szintaxis

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ám négy részből áll, amelyeket időszakok választanak el egymástól: major.minor.build.revision. A megadott 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 egy szabályzatutasí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 tudta betölteni a futtatókörnyezetet.

pwszBuildFlavor
[in] Egy sztring, amely meghatározza, hogy be kell-e tölteni a kiszolgálót vagy a CLR munkaállomás-buildét. Az érvényes értékek a és wksa.svr A kiszolgáló buildje úgy van optimalizálva, hogy kihasználja a szemétgyűjtés több processzorát, a munkaállomás buildje 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 az értékre svrvan állítva. Ha azonban be van állítvasvr, pwszBuildFlavor és egyidejű szemétgyűjtés van megadva (lásd a startupFlags paraméter leírását), a kiszolgáló buildje be lesz töltve.

Megjegyzés

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

pwszHostConfigFile
[in] Egy gazdagép konfigurációs fájljának 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 kezdeményező 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 halmaza pwszVersion . Az alapértelmezett tartomány egyetlen tartomány, ha nincs jelölő beállítva. A támogatott értékek listáját a STARTUP_FLAGS enumerálás című témakörben találja.

rclsid
[in] Az CLSIDICorRuntimeHost 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é] A betöltött futtatókörnyezet verziójára mutató felület.

Követelmények

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

Fejléc: MSCorEE.idl

Kódtár: MSCorEE.dll

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

Lásd még