LoadLibraryShim 関数LoadLibraryShim Function

指定したバージョンの .NET Framework 再頒布可能パッケージに含まれている DLL を読み込みます。Loads a specified version of a DLL that is included in the .NET Framework redistributable package.

この関数は、.NET Framework 4 では廃止されました。This function has been deprecated in the .NET Framework 4. 使用して、 iclrruntimeinfo::loadlibraryメソッド代わりにします。Use the ICLRRuntimeInfo::LoadLibrary method instead.

構文Syntax

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

パラメーターParameters

szDllName
[in].NET Framework ライブラリから読み込まれる DLL の名前を表す、0 で終わる文字列。[in] A zero-terminated string that represents the name of the DLL to be loaded from the .NET Framework library.

szVersion
[in]読み込まれる DLL のバージョンを表す、0 で終わる文字列。[in] A zero-terminated string that represents the version of the DLL to be loaded. 場合szVersion読み込みはバージョン 4 未満である指定された DLL の最新バージョンを選択したバージョンは null です。If szVersion is null, the version selected for loading is the latest version of the specified DLL that is less than version 4. 場合は、バージョン 4 以上のすべてのバージョンは無視されますszVersionが null の場合と、version 4 より前のバージョンがインストールされていない場合、DLL の読み込みに失敗します。That is, all versions equal to or greater than version 4 are ignored if szVersion is null, and if no version less than version 4 is installed, the DLL fails to load. これは、ため、.NET Framework 4 のインストールは、既存のアプリケーションまたはコンポーネントには影響しません。This is to ensure that installation of the .NET Framework 4 does not affect pre-existing applications or components. エントリを参照してください。インプロセス SxS と移行のクイック スタートCLR チームのブログにします。See the entry In-Proc SxS and Migration Quick Start in the CLR team blog.

pvReserved
将来使用するために予約されています。Reserved for future use.

phModDll
[out]モジュールのハンドルへのポインター。[out] A pointer to the handle of the module.

戻り値Return Value

このメソッドは、次の値だけでなく、WinError.h で定義されている標準のコンポーネント オブジェクト モデル (COM) エラー コードを返します。This method returns standard Component Object Model (COM) error codes, as defined in WinError.h, in addition to the following values.

リターン コードReturn code 説明Description
S_OKS_OK メソッドは正常に完了しました。The method completed successfully.
CLR_E_SHIM_RUNTIMELOADCLR_E_SHIM_RUNTIMELOAD 読み込みszDllName共通言語ランタイム (CLR) と必要なバージョンの CLR を読み込めません。 読み込む必要があります。Loading szDllName requires loading the common language runtime (CLR), and the necessary version of the CLR cannot be loaded.

RemarksRemarks

この関数は、.NET Framework 再頒布可能パッケージに含まれている Dll の読み込みに使用されます。This function is used to load DLLs that are included in the .NET Framework redistributable package. ユーザーが生成した Dll は読み込まれません。It does not load user-generated DLLs.

注意

以降、.NET Framework version 2.0 と、読み込まれる CLR Fusion.dll を読み込むとします。Beginning with the .NET Framework version 2.0, loading Fusion.dll causes the CLR to be loaded. Fusion.dll で関数が、ラッパーが、この実装は、ランタイムによって提供されるためです。This is because the functions in Fusion.dll are now wrappers whose implementations are provided by the runtime.

必要条件Requirements

プラットフォーム: システム要件に関するページを参照してください。Platforms: See System Requirements.

ヘッダー: MSCorEE.hHeader: MSCorEE.h

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

関連項目See also