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 |