Sdílet prostřednictvím

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, kterou 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ý tak, jak pwszVersion musí začínat znakem "v", za kterým následuje první tři části čísla verze (například "v1.0.1529").

Některé verze modulu CLR se instalují s prohlášením zásad, které určuje kompatibilitu s předchozími verzemi modulu CLR. Spouštěcí přecházeč pwszVersion ve výchozím nastavení vyhodnotí příkazy zásad a načte nejnovější verzi modulu runtime, která je kompatibilní s požadovanou verzí. Hostitel může vynutit vynechání vyhodnocení zásad a načtení přesné verze zadané pwszVersion 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 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 nastavená 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 nastaveno na svr. Pokud pwszBuildFlavor je ale nastavená svr možnost souběžného uvolňování paměti (viz popis parametru startupFlags ), načte se sestavení serveru.

Poznámka:

Souběžné uvolňování paměti se nepodporuje v aplikacích s emulátorem WOW64 x86 v 64bitových systémech, které implementují architekturu Intel Itanium (dříve označovanou jako IA-64). Další informace o používání WOW64 v 64bitových systémech Windows naleznete 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í hodnota je jedna doména, pokud není nastaven žádný příznak. Seznam podporovaných hodnot najdete v STARTUP_FLAGS výčtu.

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

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

ppv
[ven] Ukazatel rozhraní na verzi načteného modulu runtime.

Požadavky

Platformy: Viz požadavky na systém.

Hlavička: MSCorEE.idl

Knihovna: MSCorEE.dll

Verze rozhraní .NET Framework: Dostupné od verze 1.0

Viz také