CorBindToRuntimeHost İşlevi
Konakların bir işleme ortak dil çalışma zamanının (CLR) belirtilen bir sürümünü yüklemesini sağlar.
Bu işlev .NET Framework 4'te kullanım dışı bırakılmıştır.
Sözdizimi
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
);
Parametreler
pwszVersion
[in] Yüklemek istediğiniz CLR sürümünü açıklayan bir dize.
.NET Framework'teki sürüm numarası noktalarla ayrılmış dört bölümden oluşur: major.minor.build.revision. Olarak pwszVersion geçirilen dizenin "v" karakteriyle başlaması ve ardından sürüm numarasının ilk üç bölümüyle (örneğin, "v1.0.1529") başlaması gerekir.
CLR'nin bazı sürümleri, CLR'nin önceki sürümleriyle uyumluluğu belirten bir ilke deyimiyle yüklenir. Varsayılan olarak, başlangıç dolgusu ilke deyimlerine pwszVersion göre değerlendirilir ve istenen sürümle uyumlu çalışma zamanının en son sürümünü yükler. Bir konak, dolguyu ilke değerlendirmesini atlayıp parametresi için startupFlags STARTUP_LOADER_SAFEMODE değerini geçirerek içinde belirtilen pwszVersion tam sürümü yüklemeye zorlayabilir.
ise pwszVersion null, yöntemi CLR'nin herhangi bir sürümünü yüklemez. Bunun yerine, çalışma zamanını yükleyemediğine işaret eden CLR_E_SHIM_RUNTIMELOAD döndürür.
pwszBuildFlavor
[in] Sunucunun mu yoksa CLR'nin iş istasyonu derlemesinin mi yüklendiğini belirten bir dize. Geçerli değerler: svr ve wks. Sunucu derlemesi, atık toplama için birden çok işlemciden yararlanmak üzere iyileştirilmiştir ve iş istasyonu derlemesi tek işlemcili bir makinede çalışan istemci uygulamaları için en iyi duruma getirilmiştir.
null olarak ayarlanırsa pwszBuildFlavor iş istasyonu derlemesi yüklenir. Tek işlemcili bir makinede çalışırken, iş istasyonu derlemesi olarak ayarlanmış svrolsa pwszBuildFlavor bile her zaman yüklenir. Ancak, olarak ayarlanırsa svr ve eşzamanlı çöp toplama belirtilirse pwszBuildFlavor (parametrenin açıklamasına startupFlags bakın), sunucu derlemesi yüklenir.
Not
Eşzamanlı çöp toplama, Intel Itanium mimarisini (eski adıyla IA-64) uygulayan 64 bit sistemlerde WOW64 x86 öykünücüsü çalıştıran uygulamalarda desteklenmez. 64 bit Windows sistemlerinde WOW64 kullanma hakkında daha fazla bilgi için bkz . 32 bit Uygulamaları Çalıştırma.
pwszHostConfigFile
[in] Yüklenecek CLR sürümünü belirten bir konak yapılandırma dosyasının adı. Dosya adı tam yol içermiyorsa, dosyanın çağrıyı yapan yürütülebilir dosyayla aynı dizinde olduğu varsayılır.
pReserved
[in] Gelecekteki genişletilebilirlik için ayrılmıştır.
startupFlags
[in] Eşzamanlı çöp toplamayı, etki alanı nötr kodunu ve parametresinin pwszVersion davranışını denetleen bir bayrak kümesi. Bayrak ayarlı değilse varsayılan değer tek etki alanıdır. Desteklenen değerlerin listesi için bkz . STARTUP_FLAGS numaralandırması.
rclsid
[in] CLSID ICorRuntimeHost veya ICLRRuntimeHost arabirimini uygulayan ortak sınıfın değeri. Desteklenen değerler CLSID_CorRuntimeHost veya CLSID_CLRRuntimeHost.
riid
[in] IID İstediğiniz arabirimin. Desteklenen değerler IID_ICorRuntimeHost veya IID_ICLRRuntimeHost.
ppv
[out] Yüklenen çalışma zamanının sürümüne yönelik bir arabirim işaretçisi.
Gereksinimler
Platformlar: Bkz. Sistem Gereksinimleri.
Üst bilgi: MSCorEE.idl
Kitaplık: MSCorEE.dll
.NET Framework Sürümleri: 1.0 sürümünden itibaren kullanılabilir
