AddDllDirectory 函数 (libloaderapi.h)

  • 项目

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

语法

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 必须安装在目标平台上。

要求

要求 值
最低受支持的客户端 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