共用方式為

ICLRMetaHost::GetRuntime 方法

  • 發行項

取得 ICLRRuntimeInfo 介面，該介面會對應至特定版本的通用語言執行平台 (CLR)。 此方法會取代與 STARTUP_LOADER_SAFEMODE 旗標搭配使用的 CorBindToRuntimeEx 函式。

語法

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

參數

pwzVersion
[in]儲存在中繼資料中的.NET Framework編譯版本，格式為 「vA。B[.X]」。 A、B 和 X 是對應至主要版本、次要版本和組建編號的十進位數字。

注意

此參數必須符合.NET Framework版本的目錄名稱，因為它出現在 C：\Windows\Microsoft.NET\Framework 或 C：\Windows\Microsoft.NET\Framework64 之下。

範例值為 "v1.0.3705"、"v1.1.4322"、"v2.0.50727" 和 "v4.0.X"，其中 X 取決於所安裝的組建編號。 需要 "v" 前置詞。

riid
[in] 所需介面的識別項。 此參數目前唯一有效的值是 IID_ICLRRuntimeInfo。

ppRuntime
[out] 對應至所要求執行階段的 ICLRRuntimeInfo 介面的指標。

傳回值

這個方法會傳回下列特定的 HRESULT，以及表示方法失敗的 HRESULT 錯誤。

HRESULT 描述
S_OK 已成功完成命令。
E_POINTER pwzVersion 或 ppRuntime 為 null。

備註

此方法會與舊版介面互動，例如ICorRuntimeHost介面和舊版函式，例如已被取代的函式， (CorBindTo* 請參閱 .NET Framework 2.0 裝載 API) 中的已淘汰 CLR 裝載函式。 也就是說，使用舊版 API 載入的執行階段會顯示在新 API 中，而使用新 API 載入的執行階段則會顯示在舊版 API 中。

規格需求

平台：請參閱系統需求。

標頭：MetaHost.h

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

.NET Framework版本：自 4 起可用

另請參閱