واجهة ICLRRuntimeHost

مقالة
11/01/2010

توفير وظيفة مشابهة إلى من الواجهة ICorRuntimeHost المتوفرة في.NET Framework الإصدار 1، مع التغييرات التالية:

الإضافة SetHost عنصر تحكم أسلوب لتعيين مضيف عنصر تحكم الواجهة.
الحذف من بعض الأساليب المتوفرة بواسطة ICorRuntimeHost.

interface ICLRRuntimeHost : IUnknown {
    
    HRESULT ExecuteApplication (
        [in] LPCWSTR                   pwzAppFullName,
        [in] DWORD                     dwManifestPaths,
        [in] LPCWSTR                   *ppwzManifestPaths,   
        [in] DWORD                     dwActivationData,
        [in] LPCWSTR                   *ppwzActivationData,  
        [out] int                      *pReturnValue
    );
    
    HRESULT ExecuteInAppDomain (
        [in] DWORD                     appDomainId, 
        [in] FExecuteInDomainCallback  pCallback,
        [in] void*                     cookie
    );
    
    HRESULT ExecuteInDefaultAppDomain (
        [in] LPCWSTR                   pwzAssemblyPath, 
        [in] LPCWSTR                   pwzTypeName,
        [in] LPCWSTR                   pwzMethodName,
        [in] LPCWSTR                   pwzArgument,
        [out] DWORD                    *pReturnValue
    );
    
    HRESULT GetCLRControl (
        [out] ICLRControl              **pCLRControl
    );
    
    HRESULT GetCurrentAppDomainId (
        [out] DWORD                    *pdwAppDomainId
    );
    
    HRESULT SetHostControl (
        [in] IHostControl              *pHostControl
    );
    
    HRESULT Start();
    
    HRESULT Stop();
    
    HRESULT UnloadAppDomain (
        [in] DWORD                     dwAppDomainId
        [in] BOOL                      fWaitUntilDone
    );
    
};

الأساليب

Method	الوصف
أسلوب ICLRRuntimeHost::ExecuteApplication	يستخدم في سيناريوهات التوزيع ClickOnce يستند إلى بيان لتعيين تطبيق يتم تنشيطها في مجال جديد.
أسلوب ICLRRuntimeHost::ExecuteInAppDomain	تعين AppDomainفيه إلى تنفيذ محدد تعليمات برمجية المدارة.
أسلوب ICLRRuntimeHost::ExecuteInDefaultAppDomain	قم باستدعاء الأسلوب المحدد من المحدد نوع في التجميع المحدد.
أسلوب ICLRRuntimeHost::GetCLRControl	الحصول مؤشر واجهة من ICLRControl النوع والتي يمكن أن يستخدم المضيفين إلى cusإلىmize أوجه وقت تشغيل اللغة العامة (CLR).
أسلوب ICLRRuntimeHost::GetCurrentAppDomainId	الحصول على معرّف رقمي من AppDomainالتي هو تنفيذها حاليا.
أسلوب ICLRRuntimeHost::SetHostControl	قم بتعيين واجهة تحكم مضيف. يجب عليك يتصل SetHostControlقبل يتصل ing Start.
أسلوب ICLRRuntimeHost::يبدأ	قم بتهيئة CLR في عملية.
أسلوب ICLRRuntimeHost::إيقاف	قم بإيقاف تنفيذ تعليمات برمجية بوقت التشغيل.
أسلوب ICLRRuntimeHost::UnloadAppDomain	يلغي AppDomainالذي يتوافق مع إلى المحدد المعرّف الرقمي.

ملاحظات

يحصل على مضيف مؤشر إلى عن ICLRRuntimeHostالمثيل بواسطة استدعاء CorBindToRuntimeEx أو CorBindToCurrentRuntime . قم بتوفير طرق تطبيق أي من التقنيات المتوفرة في الإصدار 2.0 من برنامج.NET Framework، يجب استخدام ICLRRuntimeHostبدلاً من ICorRuntimeHost.

هام
لا باستدعاء ابدأ أسلوب قبل استدعاء الطريقة ExecuteApplication لتنشيط أحد تطبيقات المستندة إلى ملف البيان.If the Start أسلوب هو called أول, the ExecuteApplication أسلوب يتصل will فشل.

المتطلبات

الأنظمة الأساسية: See متطلبات النظام إطار عمل .NET.

**Header:**MSCorEE.idl

**المكتبة:**مُضمن كـ مورد في MSCorEE.dll

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

راجع أيضًا:

مشاركة عبر

واجهة ICLRRuntimeHost

الأساليب

ملاحظات

المتطلبات

راجع أيضًا:

المرجع

المبادئ

موارد أخرى

الموارد الإضافية