CorBindToRuntimeHost 函式

發行項
08/12/2011

可讓主應用程式將 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 版本的相容性。根據預設，啟動 shim 會根據原則陳述式評估 pwszVersion，並載入與所要求版本相容的最新版本的執行階段。主應用程式可以強制 Shim 略過原則評估，並載入 pwszVersion 中所指定的完全相同的版本，方法是針對 startupFlags 參數傳遞 STARTUP_LOADER_SAFEMODE 的值。

如果 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_CONCURRENT_GC：指定應使用並行的記憶體回收。如果呼叫端要求單一處理器電腦上的伺服器組建並且指定並行的記憶體回收，則會改用工作站組建和非並行的記憶體回收。
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN：指定不以定義域中性的方式載入組件。
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN：指定以定義域中性的方式載入所有組件。
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST：指定以定義域中性的方式載入所有強式名稱的組件。
- STARTUP_LOADER_SAFEMODE：指定將載入 pwszVersion 中所傳遞的完全相同的 CLR 版本。 Shim 不會評估原則以判斷最新的相容版本。
rclsid
[in] 實作 ICorRuntimeHost 或 ICLRRuntimeHost 介面之 coclass 的 CLSID。支援的值為 CLSID_CorRuntimeHost 或 CLSID_CLRRuntimeHost。
riid
[in] 您所要求介面的 IID。支援的值為 IID_ICorRuntimeHost 或 IID_ICLRRuntimeHost。
ppv
[out] 已載入執行階段版本的介面指標。