Fungsi GetDllDirectoryA (winbase.h)

Mengambil bagian khusus aplikasi dari jalur pencarian yang digunakan untuk menemukan DLL untuk aplikasi.

Sintaksis

DWORD GetDllDirectoryA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Parameter

[in] nBufferLength

Ukuran buffer output, dalam karakter.

[out] lpBuffer

Penunjuk ke buffer yang menerima bagian khusus aplikasi dari jalur pencarian.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah panjang string yang disalin ke lpBuffer, dalam karakter, tidak termasuk karakter null yang mengakhiri. Jika nilai yang dikembalikan lebih besar dari nBufferLength, nilai tersebut menentukan ukuran buffer yang diperlukan untuk jalur tersebut.

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

Komentar

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0502 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Nota

Header winbase.h mendefinisikan GetDllDirectory sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista, Windows XP dengan SP1 [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Urutan Pencarian Pustaka Dynamic-Link

setDllDirectory