LoadLibraryShim 関数

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

この関数は、.NET Framework 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 の中で、4 より前で一番新しいバージョンになります。 つまり、4 以降のバージョンはすべて、szVersion が null の場合は無視されます。4 より前のバージョンがインストールされていない場合、DLL は読み込めません。 これにより確実に、.NET Framework 4 をインストールしても、既存のアプリケーションやコンポーネントに影響を与えることがありません。 CLR チームのブログ投稿「インプロセス SxS と移行のクイックスタート」を参照してください。

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

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

戻り値

このメソッドでは、WinError.h で定義されているように、次の値に加えて標準のコンポーネント オブジェクト モデル (COM) エラー コードが返されます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
CLR_E_SHIM_RUNTIMELOAD	szDllName を読み込むには、共通言語ランタイム (CLR) を読み込む必要がありますが、必要なバージョンの CLR を読み込めません。

解説

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

Note

.NET Framework バージョン 2.0 以降では、Fusion.dll を読み込むと CLR が読み込まれます。 これはこの時点で、Fusion.dll の関数が、ランタイムによって実装されるラッパーであるためです。

必要条件

:「システム要件」を参照してください。

ヘッダー: MSCorEE.h

.NET Framework のバージョン: 1.0 以降で使用可能

関連項目

• 非推奨の CLR ホスト関数