Fungsi FtpPutFileW (wininet.h)

Artikel
11/20/2024

Menyimpan file di server FTP.

Sintaksis

BOOL FtpPutFileW(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   lpszLocalFile,
  [in] LPCWSTR   lpszNewRemoteFile,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parameter

[in] hConnect

Menangani ke 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 null-terminated 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	Arti
FTP_TRANSFER_TYPE_ASCII	Mentransfer file menggunakan metode transfer ASCII (Tipe A) FTP. Informasi kontrol dan pemformatan dikonversi ke setara lokal.
FTP_TRANSFER_TYPE_BINARY	Mentransfer file menggunakan metode transfer Gambar (Tipe I) FTP. File ditransfer persis seperti yang ada tanpa perubahan. Ini adalah metode transfer default.
FTP_TRANSFER_TYPE_UNKNOWN	Default ke FTP_TRANSFER_TYPE_BINARY.
INTERNET_FLAG_TRANSFER_ASCII	Mentransfer file sebagai ASCII.
INTERNET_FLAG_TRANSFER_BINARY	Mentransfer file sebagai biner.

Nilai berikut digunakan untuk mengontrol penembolokan file. Aplikasi dapat menggunakan satu atau beberapa nilai berikut.

Nilai	Arti
INTERNET_FLAG_HYPERLINK	Memaksa pemuatan ulang jika tidak ada waktu Kedaluwarsa dan tidak ada waktu LastModified yang dikembalikan dari server saat menentukan apakah akan memuat ulang item dari jaringan.
INTERNET_FLAG_NEED_FILE	Menyebabkan file sementara dibuat jika file tidak dapat di-cache.
INTERNET_FLAG_RELOAD	Memaksa pengunduhan file, objek, atau daftar direktori yang diminta dari server asal, bukan dari cache.
INTERNET_FLAG_RESYNCHRONIZE	Memuat ulang sumber daya HTTP jika sumber daya telah dimodifikasi sejak terakhir kali diunduh. Semua sumber daya FTP dimuat ulang. Windows XP dan Windows Server 2003 R2 dan yang lebih lama: sumber daya Gopher juga dimuat ulang.

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

Mengembalikan nilai

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

Komentar

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 ke setara lokal.

Baik lpszNewRemoteFile dan lpszLocalFile dapat berupa nama file yang 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.

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

Nota

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

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

Lihat juga

Sesi FTP

Fungsi WinINet

Bagikan melalui