Share via

enumerasi BG_JOB_STATE (bits.h)

  • Artikel

Menentukan konstanta yang menentukan berbagai status pekerjaan.

Sintaks

typedef enum BG_JOB_STATE {
  BG_JOB_STATE_QUEUED = 0,
  BG_JOB_STATE_CONNECTING,
  BG_JOB_STATE_TRANSFERRING,
  BG_JOB_STATE_SUSPENDED,
  BG_JOB_STATE_ERROR,
  BG_JOB_STATE_TRANSIENT_ERROR,
  BG_JOB_STATE_TRANSFERRED,
  BG_JOB_STATE_ACKNOWLEDGED,
  BG_JOB_STATE_CANCELLED
} ;

Konstanta

 
BG_JOB_STATE_QUEUED
Nilai: 0
Menentukan bahwa pekerjaan berada dalam antrean, dan menunggu untuk dijalankan. Jika pengguna keluar saat pekerjaan mereka ditransfer, pekerjaan akan beralih ke status antrean.
BG_JOB_STATE_CONNECTING
Menentukan bahwa BITS mencoba menyambungkan ke server. Jika koneksi berhasil, status pekerjaan menjadi BG_JOB_STATE_TRANSFERRING; jika tidak, status menjadi BG_JOB_STATE_TRANSIENT_ERROR.
BG_JOB_STATE_TRANSFERRING
Menentukan bahwa BITS mentransfer data untuk pekerjaan tersebut.
BG_JOB_STATE_SUSPENDED
Menentukan bahwa pekerjaan ditangguhkan (dijeda). Untuk menangguhkan pekerjaan, panggil metode IBackgroundCopyJob::Suspend. BITS secara otomatis menangguhkan pekerjaan saat dibuat. Pekerjaan tetap ditangguhkan sampai Anda memanggil metode IBackgroundCopyJob::Resume, metodeIBackgroundCopyJob::Complete, atau metode IBackgroundCopyJob::Cancel.
BG_JOB_STATE_ERROR
Menentukan bahwa terjadi kesalahan yang tidak dapat dipulihkan (layanan tidak dapat mentransfer file). Jika kesalahan—seperti kesalahan akses ditolak—dapat dikoreksi, maka hubungi
Metode IBackgroundCopyJob::Resume setelah kesalahan diperbaiki. Namun, jika kesalahan tidak dapat dikoreksi, maka panggil
Metode IBackgroundCopyJob::Cancel untuk membatalkan pekerjaan, atau memanggil
IBackgroundCopyJob::Metode lengkap untuk menerima bagian dari pekerjaan pengunduhan yang berhasil ditransfer.
BG_JOB_STATE_TRANSIENT_ERROR
Menentukan bahwa terjadi kesalahan yang dapat dipulihkan. BITS akan mencoba kembali pekerjaan dalam status kesalahan sementara berdasarkan interval coba lagi yang Anda tentukan (lihat metode IBackgroundCopyJob::SetMinimumRetryDelay). Status pekerjaan berubah menjadi BG_JOB_STATE_ERROR jika pekerjaan gagal membuat kemajuan (lihat metode IBackgroundCopyJob::SetNoProgressTimeout).

BITS tidak mencoba kembali pekerjaan jika jaringan terputus atau terjadi kesalahan kunci disk (misalnya, chkdsk sedang berjalan), atau Kebijakan Grup MaxInternetBandwidth adalah nol.
BG_JOB_STATE_TRANSFERRED
Menentukan bahwa pekerjaan Anda berhasil diproses. Anda harus memanggil
IBackgroundCopyJob::Metode lengkap untuk mengakui penyelesaian pekerjaan, dan untuk membuat file tersedia untuk klien.
BG_JOB_STATE_ACKNOWLEDGED
Menentukan bahwa Anda memanggil metode IBackgroundCopyJob::Complete untuk mengakui bahwa pekerjaan Anda berhasil diselesaikan.
BG_JOB_STATE_CANCELLED
Menentukan bahwa Anda memanggil
Metode IBackgroundCopyJob::Cancel untuk membatalkan pekerjaan (yaitu, untuk menghapus pekerjaan dari antrean transfer).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP
Server minimum yang didukung Windows Server 2003
Header bits.h

Lihat juga