AddDllDirectory 函数 （libloaderapi.h）

将目录添加到进程 DLL 搜索路径。

Syntax

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

参数

[in] NewDirectory

要添加到搜索路径的目录的绝对路径。 例如，若要将目录 Dir2 添加到进程 DLL 搜索路径，请指定 \Dir2。 有关路径的详细信息，请参阅 命名文件、路径和命名空间。

返回值

如果函数成功，则返回值是一个不透明的指针，可以传递给 RemoveDllDirectory 以从进程 DLL 搜索路径中删除 DLL。

如果函数失败，则返回值为零。 若要获取扩展的错误信息，请调用 GetLastError。

注解

AddDllDirectory 函数可用于向搜索 DLL 的目录集添加任何绝对路径。 如果首先使用 LOAD_LIBRARY_SEARCH_USER_DIRS 调用 SetDefaultDllDirectories，则使用 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。

要求