دالة CorBindToRuntime

مقالة
11/01/2010

تمكن من مضيفي غير المدارة إلى تحميل وقت تشغيل اللغة العامة (CLR) في إلى عملية.

لقد تم مهمل هذه دالة في .NET Framework الإصدار 4.

HRESULT CorBindToRuntime (
    [in]  LPCWSTR     pwszVersion, 
    [in]  LPCWSTR     pwszBuildFlavor, 
    [in]  REFCLSID    rclsid, 
    [in]  REFIID      riid, 
    [out] LPVOID FAR  *ppv
);

المعلمات

pwszVersion
[في] سلسلة تصف الإصدار CLR الذي تريده إلى تحميل.

A الإصدار رقم في the .NET Framework consists of الرابع parts separated بواسطة periods: رئيسي.ثانوي.بنية.المراجعة. The سلسلة passed كـ pwszVersion must يبدأ مع the حرف "v" followed بواسطة the أول three parts of the الإصدار رقم (for مثال, "v1.0.1529").

Some versions of the CLR are installed مع a سياسة كشف that specifies توافق مع السابق versions of the CLR. بواسطة الافتراضي, the بدء التشغيل shim evaluates pwszVersion against سياسة statements و loads the latest الإصدار of the وقت التشغيل that هو متوافق مع the الإصدار being requested. يمكن لمضيف فرض الرقاقة إلى تخطي تقييم النهج وتحميل الإصدار الصحيح المحدد في pwszVersionبتمرير القيمة STARTUP_LOADER_SAFEMODE flagsمعلمة، كما هو موضح أدناه.

في حالة المتصل بتعيين قيمة خالية ل pwszVersion، أحدث الإصدار وقت التشغيل هو تم تحميله. تمرير null تمنح مضيف لا التحكم الإصدار وقت التشغيل هو تم تحميله. على الرغم من أن th هو قد يكون هذا الأسلوب المناسب في بعض السيناريوهات، فإنه هو المستحسن أن يقوم مضيف بتوفير نسخة محددة لتحميل.
pwszBuildFlavor
[في] A سلسلة that specifies whether إلى تحميل the الخادم أو the workstation بنية of the CLR. صالح قيم are svr و wks. The الخادم بنية هو الأمثل إلى يستفيد of multiple processors for garbage collections, و the workstation بنية هو الأمثل for العميل applications running تشغيل a مفرد-processor آلة.

If pwszBuildFlavoris set to null, the workstation build is loaded. When running on a single-processor machine, the workstation build is always loaded, even if pwszBuildFlavoris set to svr. However, if pwszBuildFlavoris set to svr and concurrent garbage collection is specified (see the description of the flags parameter), the server build is loaded.
rclsid
[في] CLSIDمن coclass الذي يطبق واجهة ICorRuntimeHost . Supported values are CLSID_CorRuntimeHostor CLSID_CLRRuntimeHost.
riid
[في] IIDمن المطلوب واجهة من rclsid. قيم المعتمدة هي IID_ICorRuntimeHost أو IID_ICLRRuntimeHost.
ppv
[خارج] مؤشر الواجهة التي يتم إرجاعها إلى riid.

ملاحظات

في حالة pwszVersionتحديد الإصدار وقت تشغيل غير موجود، CorBindToRuntimeExإرجاع القيمة HRESULT من CLR_E_SHIM_RUNTIMELOAD.

سياق التنفيذ و تدفق من هوية Windows

في الإصدار 1 من CLR، WindowsIdentityلم تدفق كائن عبر غير متزامن نقاط مثل عمليات جزئية الجديد تجمعات مؤشر ترابط أو عمليات الاسترجاعات مؤقت. في الإصدار 2.0 من CLR ExecutionContextكائن التفاف بعض المعلومات المتعلقة بمسار التنفيذ قيد التنفيذ حاليا ويسري عبر أي غير متزامن، ولكن ليس عبر حدود مجال تطبيق. وبشكل مماثل، WindowsIdentityأنساب "الكائن" أيضا عبر أي غير متزامن يؤشر. ولذلك، التمثيل الحالي تشغيل مؤشر ترابط، أن وجدت، يتدفق جداً.

يمكنك تغيير تدفق بطريقتين:

بواسطة تعديل ExecutionContextإعدادات إلى منع تدفق تشغيل أساس كل مسار تنفيذ (انظر SuppressFlow، SuppressFlow، و SuppressFlowWindowsIdentityوظائف).
بواسطة تغيير عملية الوضع الافتراضي لوضع توافق الإصدار 1، الموقع WindowsIdentityلا تدفق الكائن عبر أي يؤشر غير المتزامنة، بغض النظر عن ExecutionContextالإعدادات تشغيل مؤشر ترابط الحالي. كيف تقوم بتغيير الوضع الافتراضي يعتمد تشغيل ما إذا كنت تستخدم الملف القابل للتنفيذ مدار أو واجهة غير مدارة استضافة إلى تحميل CLR:
1. للملفات التنفيذية التي تمت إدارتها، يجب أن التعيين enabledالسمة من العنصر <legacyImpersonationPolicy> من إلى true.
2. لغير مدارة استضافة الواجهات، التعيين STARTUP_LEGACY_IMPERSONATIONوضع علامة في flagsمعلمة عند استدعاء CorBindToRuntimeExدالة.
يتم تطبيق الوضع توافق الإصدار 1 لعملية كاملة و إلى كافة مجالات التطبيق في العملية.