Share via

CorBindToRuntimeHost İşlevi

  • Makale

Konakların bir işleme ortak dil çalışma zamanının (CLR) belirli 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 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 deyimlerini değerlendirir pwszVersion ve çalışma zamanının istenen sürümle uyumlu en son sürümünü yükler. Bir konak, parametre için startupFlags STARTUP_LOADER_SAFEMODE değerini geçirerek dolguyu ilke değerlendirmesini atlayıp belirtilen pwszVersion tam sürümü yüklemeye zorlayabilir.

eğer pwszVersionnull, yöntemi CLR'nin herhangi bir sürümünü yüklemiyorsa. Bunun yerine, çalışma zamanını yükleyemediğine işaret eden CLR_E_SHIM_RUNTIMELOAD döndürür.

pwszBuildFlavor
[in] Sunucunun veya CLR'nin iş istasyonu derlemesinin yüklenip yüklenmeyeceğini belirten bir dize. Geçerli değerler ve wksdeğerleridirsvr. 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 iyileştirilmiştir.

null olarak ayarlanırsa pwszBuildFlavor iş istasyonu derlemesi yüklenir. Tek işlemcili bir makinede çalışırken, olarak ayarlanmış svrolsa pwszBuildFlavor bile iş istasyonu derlemesi her zaman yüklenir. Ancak, olarak ayarlanırsa svr ve eş zamanlı çöp toplama belirtilirse pwszBuildFlavor (parametresinin 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üklenemiyor 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ı nötr kodu ve parametresinin pwszVersion davranışını denetleen bir dizi bayrak. 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] CLSIDICorRuntimeHost veya ICLRRuntimeHost arabirimini uygulayan coclass 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ı sürümünün arabirim işaretçisi.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.idl

Kitaplık: MSCorEE.dll

.NET Framework Sürümleri: 1.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.