共用方式為


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_DIRSLoadLibraryEx 函數調用。

如果使用 AddDllDirectory 將多個目錄新增至進程 DLL 搜尋路徑,則未指定搜尋這些目錄的順序。

若要移除使用 AddDllDirectory 新增的目錄,請使用 RemoveDllDirectory 函式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008: 若要在應用程式中使用此函式,請呼叫 GetProcAddress 以從 Kernel32.dll 擷取函式的位址。 KB2533623 必須安裝在目標平臺上。

規格需求

需求
最低支援的用戶端 Windows 8 [僅限桌面應用程式],KB2533623 Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 libloaderapi.h (包含 Windows.h)
DLL Kernel32.dll