CorBindToRuntime İşlevi

Yönetilmeyen konakların ortak dil çalışma zamanını (CLR) bir işleme yüklemesini sağlar.

Bu işlev .NET Framework 4'te kullanım dışı bırakılmıştır.

Sözdizimi

HRESULT CorBindToRuntime (
    [in]  LPCWSTR     pwszVersion,
    [in]  LPCWSTR     pwszBuildFlavor,
    [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, aşağıda açıklandığı gibi parametresi için flags değerini STARTUP_LOADER_SAFEMODE geçirerek dolguyu ilke değerlendirmesini atlayıp belirtilen pwszVersion tam sürümü yüklemeye zorlayabilir.

Çağıran için pwszVersionnull değerini belirtirse, çalışma zamanının en son sürümü yüklenir. Null değerinin geçirilmesi, konağa çalışma zamanının hangi sürümünün yüklendiği üzerinde denetim sağlamaz. Bu yaklaşım bazı senaryolarda uygun olsa da, konağın yüklenecek belirli bir sürüm sağlaması kesinlikle önerilir.

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 flags bakın), sunucu derlemesi yüklenir.

rclsid [in] CLSIDICorRuntimeHost veya ICLRRuntimeHost arabirimini uygulayan ortak sınıfın değeri. Desteklenen değerler CLSID_CorRuntimeHost veya CLSID_CLRRuntimeHost.

riid [in] IID 'den istenen arabirimin rclsid. Desteklenen değerler IID_ICorRuntimeHost veya IID_ICLRRuntimeHost.

ppv [out] için döndürülen arabirim işaretçisi riid.

Açıklamalar

Var olmayan bir çalışma zamanı sürümü belirtirse pwszVersion , CorBindToRuntimeEx CLR_E_SHIM_RUNTIMELOAD HRESULT değerini döndürür.

CorBindToRuntimeEx ve CorBindToRuntime aynı işlemi gerçekleştirin CorBindToRuntimeEx , ancak işlevi CLR'nin davranışını belirtmek için bayraklar ayarlamanıza olanak tanır.

Windows Kimliği Yürütme Bağlamı ve Akışı

CLR'nin WindowsIdentity 1. sürümünde, nesne yeni iş parçacıkları, iş parçacığı havuzları veya zamanlayıcı geri çağırmaları gibi zaman uyumsuz noktalar arasında akış yapmaz. CLR'nin 2.0 sürümünde bir ExecutionContext nesne, şu anda yürütülen iş parçacığı hakkında bazı bilgileri sarmalar ve bunu uygulama etki alanı sınırları arasında değil, zaman uyumsuz herhangi bir noktaya akıtılır. Benzer şekilde, WindowsIdentity nesne herhangi bir zaman uyumsuz nokta boyunca da akar. Bu nedenle, iş parçacığındaki geçerli kimliğe bürünme (varsa) de akar.

Akışı iki şekilde değiştirebilirsiniz:

  1. İş parçacığı başına akışı engellemek için ayarları değiştirerek ExecutionContext (bkz SuppressFlow. , SuppressFlowve SuppressFlowWindowsIdentity yöntemleri).

  2. İşlem varsayılan modunu sürüm 1 uyumluluk moduna değiştirerek, WindowsIdentity geçerli iş parçacığındaki ayarlardan bağımsız olarak ExecutionContext nesnenin herhangi bir zaman uyumsuz nokta boyunca akmaması. Varsayılan modu nasıl değiştirdiğiniz, CLR'yi yüklemek için yönetilen yürütülebilir dosya mı yoksa yönetilmeyen bir barındırma arabirimi mi kullandığınıza bağlıdır:

    1. Yönetilen yürütülebilir dosyalar için legacyImpersonationPolicy> öğesinin< özniteliğini olarak trueayarlamanız enabled gerekir.

    2. Yönetilmeyen barındırma arabirimleri için işlevi çağırırken parametresinde flags bayrağını CorBindToRuntimeEx ayarlayınSTARTUP_LEGACY_IMPERSONATION.

    Sürüm 1 uyumluluk modu tüm işlem ve işlemdeki tüm uygulama etki alanları için geçerlidir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kitaplık: MSCorEE.dll

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

Ayrıca bakınız

  • Last updated on