AddDllDirectory 関数 (libloaderapi.h)

プロセス DLL 検索パスにディレクトリを追加します。

構文

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

パラメーター

[in] NewDirectory

検索パスに追加するディレクトリへの絶対パス。 たとえば、ディレクトリ Dir2 をプロセス DLL 検索パスに追加するには、\Dir2 を指定します。 パスの詳細については、「 ファイル、パス、および名前空間の名前付け」を参照してください。

戻り値

関数が成功した場合、戻り値は、プロセス DLL 検索パスから DLL を削除するために RemoveDllDirectory に渡すことができる不透明なポインターです。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

注釈

AddDllDirectory 関数を使用すると、DLL を検索するディレクトリのセットに絶対パスを追加できます。 SetDefaultDllDirectories が最初に LOAD_LIBRARY_SEARCH_USER_DIRS で呼び出された場合、AddDllDirectory で指定されたディレクトリがプロセス DLL 検索パスに追加されます。 それ以外の場合、AddDllDirectory 関数で指定されたディレクトリは、LOAD_LIBRARY_SEARCH_USER_DIRSを指定する LoadLibraryEx 関数呼び出しにのみ使用されます。

AddDllDirectory を使用してプロセス DLL 検索パスに複数のディレクトリを追加する場合、それらのディレクトリを検索する順序は指定されていません。

AddDllDirectory で追加されたディレクトリを削除するには、RemoveDllDirectory 関数を使用します。

Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008: アプリケーションでこの関数を使用するには、 GetProcAddress を呼び出して、Kernel32.dllから関数のアドレスを取得します。 KB2533623 ターゲット プラットフォームにインストールする必要があります。

Requirements