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 起提供

另請參閱

• 已被取代的 CLR 裝載函式