واجهة ICLRMetaHost

يوفر الطرق التي تقوم بإرجاع إصدار محدد من اللغة الشائعة وقت التشغيل (CLR) استناداً إلى رقم الإصدار الخاص به، قم بتثبيت قائمة بالجميع CLRs، قم بسرد الجميع وقت التشغيل s التي يتم تحميلها في عملية معينة، لاكتشاف إصدار CLR تستخدم لترجمة تجميع، خروج عملية باستخدام البرامج الأساسية وقت التشغيل إيقاف التشغيل، والربط لواجهة برمجة تطبيقات الاستعلام قديم.

interface ICLRMetaHost : IUnknown {
    HRESULT EnumerateInstalledRuntimes (
        [out, retval] IEnumUnknown **ppEnumerator);

    HRESULT EnumerateLoadedRuntimes (
        [in]  HANDLE hndProcess,
        [out, retval] IEnumUnknown **ppEnumerator);

    HRESULT ExitProcess (
        [in] INT32 iExitCode);

    HRESULT GetRuntime (
        [in] LPCWSTR  pwzVersion,
        [in] REFIID riid,
        [out, iid_is(riid), retval] LPVOID *ppRuntime);

    HRESULT  GetVersionFromFile (
        [in] LPCWSTR pwzFilePath,
        [out, size_is(*pcchBuffer)] LPWSTR pwzBuffer,
        [in, out] DWORD *pcchBuffer);

    HRESULT QueryLegacyV2RuntimeBinding (
        [in] REFIID riid,
        [out, iid_is(riid), retval] LPVOID *ppUnk);

    HRESULT RequestRuntimeLoadedNotification (
        [in] RuntimeLoadedCallbackFnPtr pCallbackFunction);
};

الأساليب

Method	الوصف
أسلوب ICLRMetaHost::EnumerateInstalledRuntimes	إرجاع لتعداد يحتوي تشغيل مؤشر واجهة صالح ICLRRuntimeInfo لكل الإصدار CLR الذي هو مثبتاً تشغيل جهاز كمبيوتر.
أسلوب ICLRMetaHost::EnumerateLoadedRuntimes	إرجاع لتعداد يحتوي على مؤشر واجهة صالح ICLRRuntimeInfo لكل CLR التي هو تحميلها في عملية معينة. وهذا أسلوب محل من GetVersionFromProcess.
أسلوب ICLRMetaHost::ExitProcess	يحاول إيقاف تم تحميله الجميع أوقات التشغيل بأمان ومن ثم ينهي عملية. يحل محل CorExitProcess دالة.
أسلوب ICLRMetaHost::GetRuntime	يحصل على واجهة ICLRRuntimeInfo المقابل إلى الإصدار CLR معينة. وهذا أسلوب محل دالة CorBindToRuntimeEx استخدامها مع يؤشر STARTUP_LOADER_SAFEMODE.
أسلوب ICLRMetaHost::GetVersionFromFile	الحصول على تجميع.NET Framework التحويل البرمجي للإصدار الأصلي (مخزن في بيانات التعريف)، تحديد مسار الملف الخاص به. وهذا أسلوب محل من GetFileVersion.
أسلوب ICLRMetaHost::QueryLegacyV2RuntimeBinding	واجهة الذي يمثل وقت تشغيل إرجاع إلى نهج تنشيط قديم التي تم تم منضمة، على سبيل المثال باستخدام useLegacyV2RuntimeActivationPolicyالسمة على <startup>العنصرتكوين ملف الإدخال، باستخدام واجهات برمجة التطبيقات قديم للتنشيط المباشر أو بواسطة استدعاء ICLRRuntimeInfo::BindAsLegacyV2Runtime الطريقة.
أسلوب ICLRMetaHost::RequestRuntimeLoadedNotification	تضمن رد اتصال مؤشر دالة معينة عند وجود الإصدار CLR أول تم تحميله، ولكن لم تبدأ بعد. وهذا أسلوب محل من LockClrVersion

ملاحظات

الطريقة الوحيدة للحصول على مثيل th هو واجهة هو عن طريق استدعاء CLRCreateInstance دالة كما يلي:

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_CLRMetaHost, (LPVOID*)&pMetaHost);

المتطلبات

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

**Header:**MetaHost.idl

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

.NET Framework Versions: 4

راجع أيضًا:

موارد أخرى

استضافة واجهات

استضافة (مرجع API غير مدارة)