共用方式為

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 修正。