Fungsi FtpGetCurrentDirectoryA (wininet.h)

  • Artikel

Mengambil direktori saat ini untuk sesi FTP yang ditentukan.

Sintaks

BOOL FtpGetCurrentDirectoryA(
  [in]      HINTERNET hConnect,
  [out]     LPSTR     lpszCurrentDirectory,
  [in, out] LPDWORD   lpdwCurrentDirectory
);

Parameter

[in] hConnect

Menangani ke sesi FTP.

[out] lpszCurrentDirectory

Penunjuk ke string yang dihentikan null yang menerima jalur absolut direktori saat ini.

[in, out] lpdwCurrentDirectory

Penunjuk ke variabel yang menentukan panjang buffer, dalam TCHAR. Panjang buffer harus mencakup ruang untuk karakter null yang mengakhiri. Menggunakan panjang MAX_PATH cukup untuk semua jalur. Ketika fungsi kembali, variabel menerima jumlah karakter yang disalin ke dalam buffer.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan pesan kesalahan tertentu, panggil GetLastError.

Keterangan

Jika buffer lpszCurrentDirectory tidak cukup besar, lpdwCurrentDirectory menerima jumlah byte yang diperlukan untuk mengambil nama direktori lengkap saat ini.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).
 

Catatan

Header wininet.h mendefinisikan FtpGetCurrentDirectory sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header wininet.h
Pustaka Wininet.lib
DLL Wininet.dll

Lihat juga

Sesi FTP

FtpSetCurrentDirectory

Fungsi WinINet