Fungsi FtpPutFileA (wininet.h)
Menyimpan file pada server FTP.
Sintaks
BOOL FtpPutFileA(
[in] HINTERNET hConnect,
[in] LPCSTR lpszLocalFile,
[in] LPCSTR lpszNewRemoteFile,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parameter
[in] hConnect
Menangani sesi FTP.
[in] lpszLocalFile
Penunjuk ke string yang dihentikan null yang berisi nama file yang akan dikirim dari sistem lokal.
[in] lpszNewRemoteFile
Penunjuk ke string yang dihentikan null yang berisi nama file yang akan dibuat pada sistem jarak jauh.
[in] dwFlags
Kondisi di mana transfer terjadi. Aplikasi harus memilih satu jenis transfer dan salah satu bendera yang mengontrol bagaimana penembolokan file akan dikontrol.
Jenis transfer bisa menjadi salah satu nilai berikut.
Nilai berikut digunakan untuk mengontrol penembolokan file. Aplikasi dapat menggunakan satu atau beberapa nilai berikut.
[in] dwContext
Penunjuk ke variabel yang berisi nilai yang ditentukan aplikasi yang mengaitkan pencarian ini dengan data aplikasi apa pun. Parameter ini hanya digunakan jika aplikasi telah memanggil InternetSetStatusCallback untuk menyiapkan panggilan balik status.
Nilai kembali
Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan pesan kesalahan tertentu, panggil GetLastError.
Keterangan
FtpPutFile adalah rutinitas tingkat tinggi yang menangani semua pembukuan dan overhead yang terkait dengan membaca file secara lokal dan menyimpannya di server FTP. Aplikasi yang hanya perlu mengirim data file, atau yang memerlukan kontrol ketat atas transfer file, harus menggunakan fungsi FtpOpenFile dan InternetWriteFile .
Jika parameter dwFlags menentukan FILE_TRANSFER_TYPE_ASCII, terjemahan data file mengonversi karakter kontrol dan pemformatan menjadi setara lokal.
Baik lpszNewRemoteFile dan lpszLocalFile dapat berupa nama file sebagian atau sepenuhnya memenuhi syarat relatif terhadap direktori 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
Header wininet.h mendefinisikan FtpPutFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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 |