Menyelesaikan dan Membatalkan Pekerjaan

Untuk menyelesaikan pekerjaan transfer, panggil metode IBackgroundCopyJob::Complete . Untuk pekerjaan pengunduhan, Anda dapat memanggil metode Lengkap sebelum semua file dalam pekerjaan telah ditransfer (sebelum status pekerjaan BG_JOB_STATE_TRANSFERRED). Hanya file yang berhasil ditransfer BITS ke klien sebelum Anda memanggil metode Lengkap yang tersedia untuk pengguna.

Untuk pekerjaan pengunggahan, panggil metode Lengkap hanya jika status pekerjaan BG_JOB_STATE_TRANSFERRED. Untuk menentukan kapan status pekerjaan BG_JOB_STATE_TRANSFERRED, polling properti status pekerjaan atau daftar untuk menerima pemberitahuan peristiwa BG_NOTIFY_JOB_TRANSFERRED.

Untuk membatalkan pekerjaan transfer, panggil metode IBackgroundCopyJob::Cancel . Metode Batal menghapus pekerjaan dari antrean transfer dan menghapus file sementara dari klien. Biasanya, Anda memanggil metode ini jika Anda tidak dapat mengatasi kesalahan yang terkait dengan pekerjaan.

Metode Batalkan membatalkan unggahan jika unggahan tidak selesai. Jika unggahan selesai, dan pekerjaan berjenis BG_JOB_TYPE_UPLOAD_REPLY, metode membatalkan balasan.

Jika Anda tidak memanggil metode Lengkap atau metode IBackgroundCopyJob::Cancel dalam waktu 90 hari (Kebijakan Grup JobInactivityTimeout default), layanan akan membatalkan pekerjaan. Jika layanan membatalkan pekerjaan, file yang diunduh dan file balasan tidak tersedia untuk klien; pembatalan pekerjaan tidak memengaruhi file yang berhasil diunggah. Anda harus selalu memanggil metode Selesai atau Batal dan tidak bergantung pada kebijakan JobInactivityTimeout untuk membersihkan pekerjaan Anda. Pekerjaan yang tersisa dalam antrean dapat mencegah pengguna membuat pekerjaan lain jika batas kebijakan MaxJobsPerUser atau MaxJobsPerMachine tercapai.