ICLRMetaHost 介面

更新：2010 年 9 月

提供方法，此方法會根據傳回 Common Language Runtime (CLR) 版本號碼傳回某個特定版本、列出所有已安裝的 CLR、列出在指定的處理序中載入的所有執行階段、找出用來編譯組件、結束處理序與初始狀態的執行階段的關機，以及查詢舊版 API 繫結的 CLR 版本。

方法

方法	描述
ICLRMetaHost::EnumerateInstalledRuntimes 方法	針對安裝在電腦中的每個 CLR 版本，傳回包含有效 ICLRRuntimeInfo 介面指標的列舉。
ICLRMetaHost::EnumerateLoadedRuntimes 方法	針對已載入指定之處理序的所有現有 CLR，傳回包含有效的 ICLRRuntimeInfo 介面指標的列舉。這個方法會取代 GetVersionFromProcess。
ICLRMetaHost::ExitProcess 方法	嘗試順利關閉所有已載入的執行階段，然後終止處理序。取代 CorExitProcess 函式。
ICLRMetaHost::GetRuntime 方法	取得對應特定 CLR 版本的 ICLRRuntimeInfo 介面。這個方法會取代搭配 STARTUP_LOADER_SAFEMODE 旗標使用的 CorBindToRuntimeEx 函式。
ICLRMetaHost::GetVersionFromFile 方法	取得組件的原始 .NET Framework 編譯版本 (儲存在中繼資料中)，於指定的檔案路徑。這個方法會取代 GetFileVersion。
ICLRMetaHost::QueryLegacyV2RuntimeBinding 方法	傳回代表舊版啟動原則已繫結的介面，例如藉由使用 <startup> 項目組態檔項目上的 useLegacyV2RuntimeActivationPolicy 屬性、直接使用舊版啟動 API，或者藉由呼叫 ICLRRuntimeInfo::BindAsLegacyV2Runtime 方法。
ICLRMetaHost::RequestRuntimeLoadedNotification 方法	當首次載入某個 CLR 版本，但尚未啟動時，保證指定之函式指標的回呼。這個方法會取代 LockClrVersion。

取得這個介面的執行個體唯一的方法就是呼叫 CLRCreateInstance 函式，如下所示：

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

標頭：MetaHost.h

程式庫：包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本：**4

日期	記錄	原因
2010 年 9 月	已更正程式碼清單中的 IID。	客戶回函。

2010 年 9 月

已更正程式碼清單中的 IID。

客戶回函。