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

IBackgroundCopyCallback

IBackgroundCopyCallback2