Fungsi AddDllDirectory (libloaderapi.h)

  • Artikel

Menambahkan direktori ke jalur pencarian DLL proses.

Sintaks

DLL_DIRECTORY_COOKIE AddDllDirectory(
  [in] PCWSTR NewDirectory
);

Parameter

[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.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk 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, hubungi GetLastError.

Keterangan

Fungsi AddDllDirectory dapat digunakan untuk menambahkan jalur absolut apa pun ke kumpulan direktori yang dicari 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 [khusus 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]
Target Platform Windows
Header libloaderapi.h (termasuk Windows.h)
DLL Kernel32.dll