ICLRMetaHost::GetRuntime 方法

發行項
08/12/2011

取得對應至 Common Language Runtime (CLR) 之特定版本的 ICLRRuntimeInfo 介面。這個方法會取代搭配 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 介面的指標。

注意事項
此參數必須符合 .NET Framework 版本的目錄名稱，也就是在 C:\Windows\Microsoft.NET\Framework 或 C:\Windows\Microsoft.NET\Framework64 下出現的名稱。

傳回值

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

HRESULT	描述
S_OK	此方法已成功完成。
E_POINTER	pwzVersion 或 ppRuntime 為 null。

備註

這個方法會與舊版介面一致地互動，例如 ICorRuntimeHost 介面和舊版函式，像是已取代的 CorBindTo* 函式 (請參閱 .NET Framework 2.0 裝載 API 中的裝載全域靜態函式的 .NET Framework 1.1 和 2.0)。也就是說，新的 API 可以看到用舊版 API 載入的執行階段，而舊版 API 也可看到用新 API 載入的執行階段。 .