setDllDirectoryA 函数 (winbase.h)

将目录添加到用于查找应用程序的 DLL 的搜索路径。

语法

BOOL SetDllDirectoryA(
  [in, optional] LPCSTR lpPathName
);

[in, optional] lpPathName

要添加到搜索路径的目录。如果此参数是空字符串 (“”) ，则调用将从默认 DLL 搜索顺序中删除当前目录。如果此参数为 NULL，则该函数将还原默认搜索顺序。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

SetDllDirectory 函数会影响对 LoadLibrary 和 LoadLibraryEx 函数的所有后续调用。当指定的目录位于搜索路径中时，它还可有效地禁用安全 DLL 搜索模式。

注意

对于未运行打包或受保护进程的 Win32 进程，调用此函数还会影响从调用函数的进程启动的子进程的 DLL 搜索顺序。

调用 SetDllDirectory 后，标准 DLL 搜索路径为：

每次调用 SetDllDirectory 函数时，它都会替换上一次 SetDllDirectory 调用中指定的目录。若要指定多个目录，请使用 AddDllDirectory 函数并使用 LOAD_LIBRARY_SEARCH_USER_DIRS调用 LoadLibraryEx 。

若要还原 LoadLibrary 和 LoadLibraryEx 使用的标准搜索路径，请使用 NULL 调用 SetDllDirectory。这也基于 SafeDllSearchMode 注册表值还原安全 DLL 搜索模式。

若要编译使用此函数的应用程序，请将_WIN32_WINNT定义为 0x0502 或更高版本。有关详细信息，请参阅使用 Windows 标头。

注意

winbase.h 标头将 SetDllDirectory 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求	值
最低受支持的客户端	Windows Vista、带 SP1 的 Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll