CorBindToRuntimeHost 函式
可讓主機將指定版本的 Common Language Runtime (CLR) 載入至進程。
此函式已在 .NET Framework 4 中已被取代。
語法
HRESULT CorBindToRuntimeHost (
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pwszBuildFlavor,
[in] LPCWSTR pwszHostConfigFile,
[in] VOID* pReserved,
[in] DWORD startupFlags,
[in] REFCLSID rclsid,
[in] REFIID riid,
[out] LPVOID FAR *ppv
);
參數
pwszVersion
[in]描述您要載入之 CLR 版本的字串。
.NET Framework 中的版本號碼包含以句點分隔的四個部分: major.minor.build.revision。 傳遞的 pwszVersion
字串必須以字元 「v」 開頭,後面接著版本號碼的前三個部分(例如,“v1.0.1529” )。
某些版本的 CLR 會隨原則語句一起安裝,以指定與舊版 CLR 的相容性。 根據預設,啟動填充碼會 pwszVersion
根據原則語句進行評估,並載入與所要求版本相容的最新版本運行時間。 主機可以強制填充碼略過原則評估,並傳遞 參數的 STARTUP_LOADER_SAFEMODE startupFlags
值,以載入 中指定的pwszVersion
確切版本。
如果 pwszVersion
為 null
,則方法不會載入任何版本的 CLR。 相反地,它會傳回CLR_E_SHIM_RUNTIMELOAD,表示它無法載入運行時間。
pwszBuildFlavor
[in]指定載入伺服器或 CLR 工作站組建的字串。 有效值為 svr
和 wks
。 伺服器組建已優化以利用多個處理器進行垃圾收集,而工作站組建則針對在單一處理器計算機上執行的用戶端應用程式優化。
如果 pwszBuildFlavor
設定為 null,則會載入工作站組建。 在單一處理器計算機上執行時,即使 設定為 svr
,pwszBuildFlavor
工作站組建一律會載入。 不過,如果 pwszBuildFlavor
設定為 , svr
且已指定並行垃圾收集(請參閱 參數的描述 startupFlags
),則會載入伺服器組建。
注意
在實作 Intel Itanium 架構的 64 位系統上執行 WOW64 x86 模擬器的應用程式不支援並行垃圾收集(先前稱為 IA-64)。 如需在64位 Windows 系統上使用 WOW64 的詳細資訊,請參閱 執行 32 位應用程式。
pwszHostConfigFile
[in]指定要載入之 CLR 版本的主機組態檔名稱。 如果檔名不包含完整路徑,則會假設檔案位於與進行呼叫的可執行檔相同的目錄中。
pReserved
[in]保留給未來的擴充性。
startupFlags
[in]一組旗標,控制並行垃圾收集、網域中性程式代碼和 參數的行為 pwszVersion
。 如果未設定旗標,則預設值為單一網域。 如需支援值的清單,請參閱 STARTUP_FLAGS列舉。
rclsid
[in]實作 ICorRuntimeHost 或 ICLRRuntimeHost 介面之 coclass 的 。CLSID
支援的值為CLSID_CorRuntimeHost或CLSID_CLRRuntimeHost。
riid
[in] IID
您要求之介面的 。 支援的值為IID_ICorRuntimeHost或IID_ICLRRuntimeHost。
ppv
[out]載入之運行時間版本的介面指標。
需求
平台:請參閱系統需求。
標頭: MSCorEE.idl
連結庫: MSCorEE.dll
.NET Framework 版本: 自 1.0 起提供