LoadLibraryShim 関数

更新 : 2010 年 8 月

.NET Framework 再頒布可能パッケージに含まれる指定したバージョンの DLL を読み込みます。

この関数は、.NET Framework Version 4 では推奨されていません。 代わりに、ICLRRuntimeInfo::LoadLibrary メソッドを使用してください。

HRESULT LoadLibraryShim (
    [in]  LPCWSTR  szDllName,
    [in]  LPCWSTR  szVersion,
          LPVOID   pvReserved,
    [out] HMODULE *phModDll
);

パラメーター

• szDllName
  [入力] .NET Framework ライブラリから読み込まれる DLL の名前を表し、ゼロで終了する文字列。

• szVersion
  [入力] 読み込まれる DLL のバージョンを表し、ゼロで終了する文字列。 szVersion が null の場合は、指定した DLL の最新バージョン (ただし、Version 4 未満) が読み込まれます。 つまり、szVersion が null の場合、Version 4 以上のバージョンはすべて無視され、Version 4 未満のバージョンがインストールされていないときは DLL の読み込みに失敗します。 これは、.NET Framework 4 のインストールが既存のアプリケーションやコンポーネントに影響しないようにするためです。 CLR チーム ブログの「In-Proc SxS and Migration Quick Start (In-Proc SxS と移行のクイック スタート)」を参照してください。

• pvReserved
  将来使用するために予約されています。

• phModDll
  [出力] モジュールのハンドルへのポインター。

戻り値

このメソッドは、WinError.h で定義された標準のコンポーネント オブジェクト モデル (COM: Component Object Model) エラー コードの他、次の値も返します。

解説

この関数は、.NET Framework 再頒布可能パッケージに含まれる DLL の読み込みに使用されます。 ユーザー生成の DLL は読み込みません。

メモ
.NET Framework Version 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 のホスト グローバル静的関数

履歴の変更