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
S_OK	Pekerjaan berhasil dibatalkan.
BG_S_UNABLE_TO_DELETE_FILES	Pekerjaan berhasil dibatalkan; namun, layanan tidak dapat menghapus file sementara yang terkait dengan pekerjaan tersebut.
BG_E_INVALID_STATE	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

Lihat juga

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Tangguhkan