IBackgroundCopyJob::Batalkan metode (bits.h)
Menghapus pekerjaan dari antrean transfer dan menghapus file sementara terkait dari klien (unduhan) dan server (unggahan).
Sintaks
HRESULT Cancel();
Mengembalikan nilai
Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.
Menampilkan kode | Deskripsi |
---|---|
|
Pekerjaan berhasil dibatalkan. |
|
Pekerjaan berhasil dibatalkan; namun, layanan tidak dapat menghapus file sementara yang terkait dengan pekerjaan tersebut. |
|
Tidak dapat membatalkan pekerjaan yang statusnya BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED. |
Keterangan
Anda dapat membatalkan pekerjaan kapan saja; namun, pekerjaan tidak dapat dipulihkan setelah dibatalkan.
Untuk pekerjaan unggah, jika server tidak tersedia, mungkin ada penundaan sebelum BITS menghapus pekerjaan dari antrean. BITS secara berkala mengirimkan permintaan pembatalan ke server BITS hingga 24 jam. Jika server tidak merespons dalam periode 24 jam, BITS akan menghapus pekerjaan dari antrean. Jika periode waktu habis tidak ada kemajuan kurang dari 24 jam, BITS menggunakan periode waktu habis tanpa kemajuan untuk membatasi percobaan ulang.
Metode Batalkan membatalkan unggahan jika unggahan tidak selesai. Jika unggahan selesai dan pekerjaan berjenis BG_JOB_TYPE_UPLOAD_REPLY, metode membatalkan balasan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP |
Server minimum yang didukung | Windows Server 2003 |
Target Platform | Windows |
Header | bits.h |
Pustaka | Bits.lib |
DLL | QmgrPrxy.dll |