LoadLibraryShim 函式
更新:2010 年 8 月
載入包含在 .NET Framework 可轉散發套件中的 DLL 指定版本。
這個函式在 .NET Framework 4 版 中已被取代。 改用 ICLRRuntimeInfo::LoadLibrary 方法。
HRESULT LoadLibraryShim (
[in] LPCWSTR szDllName,
[in] LPCWSTR szVersion,
LPVOID pvReserved,
[out] HMODULE *phModDll
);
參數
szDllName
[in] 以零結尾的字串,表示要從 .NET Framework 程式庫載入的 DLL 名稱。szVersion
[in] 以零結尾的字串,表示要載入的 DLL 版本。 如果szVersion是 null,選定載入的版本是指定 DLL 中小於第 4 版的最新版本。 也就是說,如果 szVersion 是 Null,所有相當於或第 4版更新的版本都會被忽略,如果未安裝任何早於第 4 版的版本,DLL 就無法載入。 這是為了確保 .NET Framework 4 的安裝不會影響既有的應用程式或元件。 請參閱 CLR 小組部落格中的項目 In-Proc SxS and Migration Quick Start。pvReserved
保留供將來使用。phModDll
[out] 模組控制代碼的指標。
傳回值
除了下列的值以外,這個方法還會傳回在 WinError.h 中定義的標準元件物件模型 (COM) 錯誤碼。
傳回碼 |
描述 |
---|---|
S_OK |
此方法已成功完成。 |
CLR_E_SHIM_RUNTIMELOAD |
載入szDllName必須載入 common language runtime (CLR),但無法載入所需的 CLR 版本。 |
備註
這個函式是用來載入包含在 .NET Framework 可轉散發套件中的 DLL, 它不會載入使用者產生的 DLL。
注意事項 |
---|
從 NET Framework 2.0 版開始,載入 Fusion.dll 會導致載入 CLR。這是因為 Fusion.dll 中的函式現在是由執行階段提供其實作的包裝函式。 |
需求
**平台:**請參閱 .NET Framework 系統需求。
**標頭:**MSCorEE.h
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1、1.0
請參閱
其他資源
裝載全域靜態函式的 .NET Framework 1.1 和 2.0
變更記錄
日期 |
記錄 |
原因 |
---|---|---|
2010 年 8 月 |
描述 .NET Framework 4 流程中的並存行為。 新增傳回值的清單。 新增取代方法的替代方法。 |
內容 Bug 修正。 |