LoadLibraryExA 関数 (libloaderapi.h)

LoadLibraryEx が、LOAD_LIBRARY_AS_DATAFILE、LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE、または LOAD_LIBRARY_AS_IMAGE_RESOURCEを持つ同じファイルに対して 2 回呼び出されると、ファイルに対して 2 つの個別のマッピングが作成されます。

LOAD_LIBRARY_AS_IMAGE_RESOURCE 値を使用すると、ポータブル実行可能 (PE) セクション配置拡張を使用して、モジュールがイメージとして読み込まれます。 相対仮想アドレス (RVA) をディスク アドレスにマップする必要がないため、モジュールからリソースをより迅速に取得できます。 LOAD_LIBRARY_AS_IMAGE_RESOURCE を指定すると、モジュールの読み込み中に他のプロセスがモジュールを変更できなくなります。

アプリケーションが特定のイメージ マッピング特性に依存しない限り、LOAD_LIBRARY_AS_IMAGE_RESOURCE 値は LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE または LOAD_LIBRARY_AS_DATAFILEで使用する必要があります。 これにより、ローダーはモジュールをイメージ リソースとして読み込むかデータ ファイルとして読み込むかを選択し、システムがページをより効果的に共有できるようにするオプションを選択できます。 FindResource などのリソース関数では、どちらのマッピングも使用できます。

モジュールの読み込み方法を確認するには、次のいずれかのマクロを使用して、LoadLibraryExによって返されるハンドル テストします。

#define LDR_IS_DATAFILE(handle)      (((ULONG_PTR)(handle)) &  (ULONG_PTR)1)
#define LDR_IS_IMAGEMAPPING(handle)  (((ULONG_PTR)(handle)) & (ULONG_PTR)2)
#define LDR_IS_RESOURCE(handle)      (LDR_IS_IMAGEMAPPING(handle) || LDR_IS_DATAFILE(handle))

次の表では、これらのマクロについて説明します。

FreeLibrary 関数を使用して、読み込まれたモジュールを解放します。モジュールを読み込んだ場合に、その参照カウントがインクリメントされたかどうかに関係なく、 モジュールがデータまたはイメージ ファイルとして読み込まれた場合、マッピングは破棄されますが、参照カウントはデクリメントされません。 それ以外の場合は、DLL 参照カウントがデクリメントされます。 したがって、LoadLibraryExによって返されるハンドルを使用して、FreeLibrary を呼び出しても安全です。

DLL と依存関係の検索

LoadLibraryEx 関数は、次の場合に標準の検索パスを使用します。

• ファイル名はパスなしで指定され、ベース ファイル名は読み込まれたモジュールのベース ファイル名と一致せず、LOAD_LIBRARY_SEARCH フラグは使用されません。
• パスは指定されていますが、LOAD_WITH_ALTERED_SEARCH_PATH は使用されません。
• アプリケーションで、setDefaultDllDirectoriesを使用するプロセスの既定の DLL 検索パス 指定されていません。

lpFileName 相対パスを指定すると、相対パス全体が DLL 検索パス内のすべてのトークンに追加されます。 他のパスを検索せずに相対パスからモジュールを読み込むには、GetFullPathName を使用して非リレーショナル パスを取得し、非リレーショナル パス LoadLibraryEx を呼び出します。 モジュールがデータ ファイルとして読み込まれ、相対パスが "." または ".." で始まる場合、相対パスは絶対パスとして扱われます。

lpFileName が絶対パスを指定し、dwFlags が LOAD_WITH_ALTERED_SEARCH_PATHに設定されている場合、LoadLibraryEx は変更された検索パスを使用 。 この動作は、LOAD_WITH_ALTERED_SEARCH_PATH フラグが設定されている場合は未定義であり、lpFileName 相対パスを指定します。

SetDllDirectory 関数を使用して、検索パスを変更できます。 このソリューションは、SetCurrentDirectory を使用するか、DLL への完全なパスをハードコーディングするよりも優れています。 ただし、SetDllDirectory を使用すると、指定したディレクトリが検索パスにあり、スレッド セーフではない間、安全な DLL 検索モードが効果的に無効になることに注意してください。 可能であれば、AddDllDirectory を使用して、既定のプロセス検索パスを変更することをお勧めします。 詳細については、「Dynamic-Link ライブラリの検索順序」を参照してください。

アプリケーションでは、LOAD_LIBRARY_SEARCH_* フラグを使用して、1 つの LoadLibraryEx 呼び出しを検索するディレクトリを指定できます。 複数の LOAD_LIBRARY_SEARCH フラグが指定されている場合、ディレクトリは次の順序で検索されます。

• DLL (LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR) を含むディレクトリ。 このディレクトリは、読み込まれる DLL の依存関係のみを検索します。
• アプリケーション ディレクトリ (LOAD_LIBRARY_SEARCH_APPLICATION_DIR)。
• AddDllDirectory 関数 (LOAD_LIBRARY_SEARCH_USER_DIRS) または SetDllDirectory 関数を使用して、アプリケーション検索パスに明示的に追加されたパス。 複数のパスが追加されている場合、パスの検索順序は指定されません。
• System32 ディレクトリ (LOAD_LIBRARY_SEARCH_SYSTEM32)。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: KB2533623 がインストールされているシステムで LOAD_LIBRARY_SEARCH_ フラグを使用できます。 フラグが使用可能かどうかを判断するには、GetProcAddress を使用して、AddDllDirectory、RemoveDllDirectory、または SetDefaultDllDirectories 関数 アドレスを取得します。 GetProcAddress 成功した場合、LOAD_LIBRARY_SEARCH_ フラグを LoadLibraryEx使用できます。

//Load the FMAPI DLL
hLib = ::LoadLibraryEx(L"fmapi.dll", NULL, NULL);
if ( !hLib )
{
      wprintf(L"Could not load fmapi.dll, Error #%d.\n", GetLastError());
      return;
}