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 以降で使用可能
関連項目
.NET