Metode IBackgroundCopyCallback2::FileTransferred (bits3_0.h)
BITS memanggil implementasi metode FileTransferred ketika BITS berhasil menyelesaikan transfer file.
Sintaks
HRESULT FileTransferred(
[in] IBackgroundCopyJob *pJob,
[in] IBackgroundCopyFile *pFile
);
Parameter
[in] pJob
Berisi informasi terkait pekerjaan. Jangan lepaskan pJob; BITS merilis antarmuka ketika metode ini kembali.
[in] pFile
Berisi informasi terkait file. Jangan lepaskan pFile; BITS merilis antarmuka ketika metode ini kembali.
Menampilkan nilai
Metode ini harus mengembalikan S_OK; jika tidak, jika negatif, BITS terus memanggil metode ini sampai S_OK dikembalikan. Untuk alasan performa, Anda harus membatasi berapa kali Anda mengembalikan nilai selain S_OK beberapa kali. Sebagai alternatif untuk mengembalikan kode kesalahan, pertimbangkan untuk selalu mengembalikan S_OK dan menangani kesalahan secara internal. Interval di mana metode ini dipanggil bersifat arbitrer.
Keterangan
Biasanya, Anda tidak akan menggunakan panggilan balik ini kecuali Anda ingin memvalidasi konten file yang diunduh. Memvalidasi file mungkin penting bagi Anda jika Anda mengunduh konten yang dapat dilayani ke rekan-rekan.
Untuk mendapatkan nama file sementara yang berisi konten yang diunduh, panggil metode IBackgroundCopyFile3::GetTemporaryName . Setelah memverifikasi konten, panggil metode IBackgroundCopyFile3::SetValidationState untuk menunjukkan ke BITS jika konten file valid. Jika Anda mengatur status validasi ke FALSE dan kontennya berasal dari server asal, pekerjaan berpindah ke status kesalahan.
Jika konten berasal dari serekan, BITS mengunduh file dari server asal. Panggilan balik dipanggil lagi setelah transfer file dari server asal selesai.
BIT 3.0: Panggilan balik tidak dipanggil lagi setelah transfer file dari server asal selesai.
Untuk pekerjaan, panggilan balik FileTransferred diserialisasikan. BITS tidak akan mengirimkan panggilan balik untuk file berikutnya dalam pekerjaan sampai panggilan balik saat ini berhasil dikembalikan.
Panggilan balik FileTransferred dikirim sebelum panggilan balik JobTransferred dan JobError .
Panggilan balik FileTransferred adalah untuk pekerjaan pengunduhan atau bagian balasan dari pekerjaan balasan unggahan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | bits3_0.h (termasuk Bits.h) |
Pustaka | Bits.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk