LoadLibraryShim 函式
載入.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,則選取要載入的版本是小於第 4 版之指定 DLL 的最新版本。 也就是說,如果 szVersion
為 null,則會忽略等於或大於第 4 版的所有版本,如果未安裝低於第 4 版的版本,DLL 無法載入。 這是為了確保安裝.NET Framework 4 不會影響預先存在的應用程式或元件。 請參閱 CLR 小組部落格中的內含式 SxS 和移轉快速入門項目。
pvReserved
保留供未來使用。
phModDll
[out] 模組控制代碼的指標。
傳回值
除了下列值之外,此方法會傳回標準元件物件模型 (COM) 錯誤碼,如 WinError.h 所定義。
傳回碼 | 描述 |
---|---|
S_OK | 已成功完成命令。 |
CLR_E_SHIM_RUNTIMELOAD | 載入 szDllName 時需要載入通用語言執行平台 (CLR),以及無法載入的必要 CLR 版本。 |
備註
此函式用來載入包含在.NET Framework可轉散發套件中的 DLL。 其不會載入使用者產生的 DLL。
注意
從 .NET Framework 2.0 版開始,載入Fusion.dll會導致載入 CLR。 這是因為 Fusion.dll 中的函式現在是由執行階段提供實作的包裝函式。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
.NET Framework版本:自 1.0 起提供