واجهة ICLRMetaHostPolicy

مقالة
11/01/2010

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

interface ICLRMetaHostPolicy : IUnknown
{
     HRESULT GetRequestedRuntime(
          [in]  METAHOST_POLICY_FLAGS dwPolicyFlags,
          [in]  LPCWSTR pwzBinary,
          [in]  IStream *pCfgStream,
          [in, out, size_is(*pcchVersion)] LPWSTR pwzVersion,
          [in, out]  DWORD *pcchVersion,
          [out, size_is(*pcchImageVersion)] LPWSTR pwzImageVersion,
          [in, out]  DWORD *pcchImageVersion,
          [out] DWORD *pdwConfigFlags,
          [in]  REFIID  riid
          [out, iid_is(riid), retval] LPVOID *ppRuntime);
};

الأساليب

Method	الوصف
أسلوب ICLRMetaHostPolicy::GetRequestedRuntime	يوفر تشغيل واجهة CLR مفضل استناداً إلى خصائص نهج مدارة ملف تجميع وإصدار تكوين.

ملاحظات

يمكنك يحصل مرجع لهذه الواجهة باستدعاء CLRCreateInstance دالة كما هو موضح في التعليمة البرمجية التالية:

ICLRMetaHostPolicy *pMetaHostPolicy = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHostPolicy,
                   IID_CLRMetaHostPolicy, (LPVOID*)&pMetaHostPolicy);

ملاحظة
This واجهة does not actually تم تحميله أو تنشيط the CLR, but simply إرجاع the preferred CLR الإصدار based تشغيل the متوفر versions that are installed أو تم تحميله.

The .NET Framework الإصدار 4 hosting API consolidates policies so that hosts مع specific needs may استخدم أساسى functionality without incurring unintended penalties. For مثال, many of the MSCorEE.dll exports will يربط إلى a specific CLR, although a أسلوب might not logically require it. The METAHOST_POLICY_FLAGS قائمة تعداد provides ربط policies that are عام إلى the majority of hosts.