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 ターゲット プラットフォームにインストールする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]、Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008 でのKB2533623
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	libloaderapi.h (Windows.h を含む)
[DLL]	Kernel32.dll