واجهة ICLRRuntimeInfo

Provides وظائف that return معلومات حول a specific وقت تشغيل اللغة العامة (CLR), including الإصدار, الدليل, و تحميل حالة. This واجهة also provides وقت التشغيل-specific functionality without initializing the وقت التشغيل. It يتضمن the وقت التشغيل-نسبي LoadLibrary أسلوب, the وقت التشغيل وحدة نمطية?-specific GetProcAddress أسلوب, و وقت التشغيل-provided الواجهات through the GetInterface أسلوب.

interface ICLRRuntimeInfo: IUnknown
{
HRESULT BindAsLegacyV2Runtime();

HRESULT GetDefaultStartupFlags(
     [out]  DWORD *pdwStartupFlags,
     [out, size_is(*pcchHostConfigFile)] LPWSTR pwzHostConfigFile, 
     [in, out]  DWORD *pcchHostConfigFile);

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

HRESULT GetProcAddress(
     [in]  LPCSTR pszProcName,
     [out, retval] LPVOID *ppProc);

HRESULT GetRuntimeDirectory(
     [out, size_is(*pcchBuffer)] LPWSTR pwzBuffer,
     [in, out]  DWORD *pcchBuffer);

HRESULT GetVersionString(
     [out, size_is(*pcchBuffer)] LPWSTR pwzBuffer,
     [in, out]  DWORD *pcchBuffer);

HRESULT IsLoaded(
     [in]  HANDLE hndProcess,
     [out, retval] BOOL *pbLoaded);

HRESULT IsLoadable(
     [out] BOOL *pbLoadable);

HRESULT IsStarted(
     [out] BOOL *pbStarted,
     [out] DWORD *pdwStartupFlags);

HRESULT LoadErrorString(
     [in] UINT iResourceID,
     [out, size_is(*pcchBuffer)] LPWSTR pwzBuffer,
     [in, out]  DWORD *pcchBuffer,
     [in, lcid] LONG iLocaleID);

HRESULT LoadLibrary(
     [in]  LPCWSTR pwzDllName,
     [out, retval] HMODULE *phndModule);

HRESULT SetDefaultStartupFlags(
     [in]  DWORD dwStartupFlags,
     [in]  LPCWSTR pwzHostConfigFile);

};

الأساليب

Method	الوصف
أسلوب ICLRRuntimeInfo::BindAsLegacyV2Runtime	Binds this وقت التشغيل for الجميع قديم CLR الإصدار 2 تنشيط سياسة decisions.
أسلوب ICLRRuntimeInfo::GetDefaultStartupFlags	Gets the CLR بدء التشغيل علامات و مضيف ملف تكوين.
أسلوب ICLRRuntimeInfo::GetInterface	Loads the CLR في the الحالي عملية و إرجاع وقت التشغيل واجهة pointers, such كـ ICLRRuntimeHost, ICLRStrongName و IMetaDataDispenser. This أسلوب supersedes الجميع the CorBindTo* دالات.
أسلوب ICLRRuntimeInfo::GetProcAddress	Gets the العنوان of a specified دالة that was exported من the CLR associated مع this واجهة. وهذا أسلوب محل من GetRealProcAddress أسلوب.
أسلوب ICLRRuntimeInfo::GetRuntimeDirectory	الحصول على الدليل التثبيت من CLR المقترن مع هذه الواجهة. وهذا أسلوب محل من GetCORSystemDirectory أسلوب.
أسلوب ICLRRuntimeInfo::GetVersionString	يحصل عام لغة وقت التشغيل (CLR) الإصدار المعلومات المقترنة مع بواجهة ICLRRuntimeInfo معطى . وهذا أسلوب محل من GetRequestedRuntimeInfo و GetRequestedRuntimeVersion أسلوب s $ $ $ $.
أسلوب ICLRRuntimeInfo::IsLoadable	Indicates whether the وقت التشغيل associated مع this واجهة can be تم تحميله في the الحالي عملية, taking في account غير ذلك runtimes that might already be تم تحميله في the عملية.
أسلوب ICLRRuntimeInfo::IsLoaded	الإشارة في ما إذا كان CLR المقترنة مع الواجهة ICLRRuntimeInfo هو تم تحميلهها في إحدى العمليات.
أسلوب ICLRRuntimeInfo::IsLoadable	الإشارة إلى ما إذا كان CLR التي هو المقترنة مع من ICLRRuntimeInfo تشغيل الواجهة.
أسلوب ICLRRuntimeInfo::LoadErrorString	يترجم القيمة HRESULT في رسالة خطأ مناسبة للبيانات الموروثة المحددة. وهذا أسلوب محل من LoadStringRC و LoadStringRCEx أسلوب s $ $ $ $.
أسلوب ICLRRuntimeInfo::LoadLibrary	قم بتحميل مكتبة من الدليل إطار من CLR تمثيلها بواسطة واجهة ICLRRuntimeInfo. وهذا أسلوب محل من LoadLibraryShim أسلوب.
أسلوب ICLRRuntimeInfo::SetDefaultStartupFlags	قم بتعيين علامات بدء التشغيل CLR و ملف تكوين مضيف.

المتطلبات

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

**Header:**MetaHost.idl

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

.NET Framework Versions: 4

راجع أيضًا:

موارد أخرى

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

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