Share via

CorBindToRuntimeHost – funkce

  • Článek

Umožňuje hostitelům načíst zadanou verzi modulu CLR (Common Language Runtime) do procesu.

Tato funkce je v rozhraní .NET Framework 4 zastaralá.

Syntaxe

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  
);

Parametry

pwszVersion
[v] Řetězec, který popisuje verzi modulu CLR, který chcete načíst.

Číslo verze v rozhraní .NET Framework se skládá ze čtyř částí oddělených tečkami: major.minor.build.revision. Řetězec předaný jako pwszVersion musí začínat znakem "v", za kterým následují první tři části čísla verze (například "v1.0.1529").

Některé verze modulu CLR se instalují s prohlášením o zásadách, který určuje kompatibilitu s předchozími verzemi modulu CLR. Ve výchozím nastavení se počáteční shim vyhodnotí pwszVersion podle příkazů zásad a načte nejnovější verzi modulu runtime, která je kompatibilní s požadovanou verzí. Hostitel může vynutit přemíscení přeskočit vyhodnocení zásad a načíst přesnou verzi zadanou v pwszVersion souboru předáním hodnoty STARTUP_LOADER_SAFEMODE parametru startupFlags .

Pokud pwszVersion je null, metoda nenačte žádnou verzi CLR. Místo toho vrátí CLR_E_SHIM_RUNTIMELOAD, což značí, že se nepodařilo načíst modul runtime.

pwszBuildFlavor
[v] Řetězec, který určuje, zda se má načíst server nebo sestavení pracovní stanice modulu CLR. Platné hodnoty jsou svr a wks. Sestavení serveru je optimalizované tak, aby využívalo více procesorů pro uvolňování paměti, a sestavení pracovní stanice je optimalizované pro klientské aplikace spuštěné na počítači s jedním procesorem.

Pokud pwszBuildFlavor je nastavena hodnota null, sestavení pracovní stanice se načte. Při spuštění na počítači s jedním procesorem se sestavení pracovní stanice vždy načte, i když pwszBuildFlavor je nastavená na svr. Pokud pwszBuildFlavor je ale nastavená hodnota svr a je zadáno souběžné uvolňování paměti (viz popis parametru startupFlags ), načte se sestavení serveru.

Poznámka

Souběžné uvolňování paměti není podporováno v aplikacích, na kterých běží emulátor x86 WOW64 v 64bitových systémech, které implementují architekturu Intel Itanium (dříve označované jako IA-64). Další informace o používání wow64 v 64bitových systémech Windows najdete v tématu Spouštění 32bitových aplikací.

pwszHostConfigFile
[v] Název konfiguračního souboru hostitele, který určuje verzi modulu CLR, který se má načíst. Pokud název souboru neobsahuje plně kvalifikovanou cestu, předpokládá se, že soubor je ve stejném adresáři jako spustitelný soubor, který provádí volání.

pReserved
[v] Vyhrazeno pro budoucí rozšiřitelnost.

startupFlags
[v] Sada příznaků, která řídí souběžné uvolňování paměti, doménově neutrální kód a chování parametru pwszVersion . Výchozí doména je jedna doména, pokud není nastavený žádný příznak. Seznam podporovaných hodnot najdete ve výčtu STARTUP_FLAGS.

rclsid
[v] Třídy CLSID coclass, která implementuje rozhraní ICorRuntimeHost nebo ICLRRuntimeHost . Podporované hodnoty jsou CLSID_CorRuntimeHost nebo CLSID_CLRRuntimeHost.

riid
[v] Rozhraní IID , které požadujete. Podporované hodnoty jsou IID_ICorRuntimeHost nebo IID_ICLRRuntimeHost.

ppv
[out] Ukazatel rozhraní na verzi modulu runtime, který byl načten.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.idl

Knihovna: MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 1.0

Viz také