Fungsi AddDllDirectory (libloaderapi.h)

Menambahkan direktori ke jalur pencarian DLL proses.

Syntax

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Parameter-parameternya

[in] NewDirectory

Jalur absolut ke direktori untuk ditambahkan ke jalur pencarian. Misalnya, untuk menambahkan direktori Dir2 ke jalur pencarian DLL proses, tentukan \Dir2. Untuk informasi selengkapnya tentang jalur, lihat Menamai File, Jalur, dan Namespace.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah pointer buram yang dapat diteruskan ke RemoveDllDirectory untuk menghapus DLL dari jalur pencarian DLL proses.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi AddDllDirectory dapat digunakan untuk menambahkan jalur absolut apa pun ke kumpulan direktori yang dicari untuk DLL. Jika SetDefaultDllDirectories pertama kali dipanggil dengan LOAD_LIBRARY_SEARCH_USER_DIRS, direktori yang ditentukan dengan AddDllDirectory ditambahkan ke jalur pencarian DLL proses. Jika tidak, direktori yang ditentukan dengan fungsi AddDllDirectory hanya digunakan untuk panggilan fungsi LoadLibraryEx yang menentukan LOAD_LIBRARY_SEARCH_USER_DIRS.

Jika AddDllDirectory digunakan untuk menambahkan lebih dari satu direktori ke jalur pencarian DLL proses, urutan di mana direktori tersebut dicari tidak ditentukan.

Untuk menghapus direktori yang ditambahkan dengan AddDllDirectory, gunakan fungsi RemoveDllDirectory .

Windows 7, Windows Server 2008 R2, Windows Vista, dan Windows Server 2008: Untuk menggunakan fungsi ini dalam aplikasi, panggil GetProcAddress untuk mengambil alamat fungsi dari Kernel32.dll. KB2533623 harus diinstal pada platform target.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop],KB2533623 pada Windows 7, Windows Server 2008 R2, Windows Vista, dan Windows Server 2008
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Platform Target	Windows
Header	libloaderapi.h (termasuk Windows.h)
Library	kernel32. Lib
DLL	Kernel32.dll