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，並載入與所要求版本相容的最新版本執行階段。 主機可以強制填充碼略過原則評估，並傳遞 startupFlags 參數的 STARTUP_LOADER_SAFEMODE 值，以載入 pwszVersion 中指定的版本，如下所示。

如果 pwszVersion 是 null,，則方法不會載入任何版本的 CLR。 相反地，該方法會傳回 CLR_E_SHIM_RUNTIMELOAD，這表示無法載入執行階段。

pwszBuildFlavor
[in] 指定是否載入伺服器或 CLR 的工作站組建。 有效值為 svr 和 wks。 伺服器組建已經過最佳化，可利用多個處理器進行記憶體回收，而工作站組建也已針對在單一處理器電腦上執行的用戶端應用程式進行最佳化。

如果 pwszBuildFlavor 設定為 null，則系統會載入工作站組建。 在單一處理器電腦上執行時，即使 pwszBuildFlavor 設定為 svr，工作站組建仍會一律載入。 然而，如果 pwszBuildFlavor 已設定為 svr，且已指定同時記憶體回收 (請參閱 startupFlags 參數的說明)，則會載入伺服器組建。

注意

在實作 Intel Itanium 結構 (先前稱為 IA-64) 64 位元系統上執行 WOW64 x86 模擬器的應用程式不支援並行記憶體回收。 如需在 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 起提供

另請參閱