Bagikan melalui

enumerasi BITS_JOB_PROPERTY_ID (bits5_0.h)

  • Artikel

Menentukan konstanta yang menentukan ID properti untuk pekerjaan BITS.

Enumerasi ini digunakan dalam serikat BITS_JOB_PROPERTY_VALUE untuk menentukan jenis nilai yang terkandung dalam serikat pekerja.

Sintaks

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

Konstanta

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
Nilai: 1
ID yang digunakan untuk mengontrol perilaku transfer melalui seluler dan/atau jaringan serupa. Properti ini dapat diubah saat transfer sedang berlangsung - bendera biaya baru akan segera berlaku.

Properti ini menggunakan bidang DWORDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
Nilai: 2
ID yang digunakan untuk mendaftarkan panggilan balik COM oleh CLSID untuk menerima pemberitahuan tentang kemajuan dan penyelesaian pekerjaan BITS. CLSID harus merujuk ke kelas yang terkait dengan server COM di luar proses yang terdaftar. Ini juga dapat diatur ke GUID_NULL untuk menghapus CLSID pemberitahuan yang ditetapkan sebelumnya.

Properti ini menggunakan bidang CLsIDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
Nilai: 3
ID untuk menandai pekerjaan BITS bersedia mengunduh konten yang tidak mendukung persyaratan HTTP normal untuk unduhan BITS: permintaan HEAD, header Content-Length, dan header Content-Range. Mengunduh jenis konten ini adalah keikutsertaan, karena BITS tidak dapat menjeda dan melanjutkan pekerjaan unduhan tanpa dukungan tersebut. Jika pekerjaan dengan properti ini diaktifkan terganggu karena alasan apa pun, seperti hilangnya konektivitas jaringan sementara atau sistem yang di-boot ulang, BITS akan memulai ulang unduhan dari awal alih-alih melanjutkan di tempat yang ditinggalkannya. BITS juga tidak dapat membatasi penggunaan bandwidth untuk unduhan dinamis; BITS tidak akan melakukan transfer tak terputus untuk pekerjaan apa pun yang tidak memiliki BG_JOB_PRIORITY_FOREGROUND ditetapkan, jadi Anda biasanya harus mengatur prioritas tersebut setiap kali Anda menggunakan set pekerjaan sebagai memungkinkan konten dinamis.

Properti ini menggunakan bidang AktifkanBITS_JOB_PROPERTY_VALUE. Properti ini hanya didukung untuk pekerjaan BG_JOB_TYPE_DOWNLOAD . Ini tidak didukung untuk unduhan yang menggunakan FILE_RANGES. Properti ini hanya dapat diatur sebelum pertama kalinya Resume dipanggil pada pekerjaan.
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
Nilai: 4
ID untuk menandai pekerjaan BITS sebagai tidak memerlukan jaminan keandalan yang kuat. Mengaktifkan properti ini akan menyebabkan BITS menghindari informasi yang bertahan tentang kemajuan pekerjaan normal, yang biasanya dilakukan BITS secara berkala. Jika terjadi pematian yang tidak terduga, seperti kehilangan daya, selama transfer, ini akan menyebabkan BITS kehilangan kemajuan

dan mulai ulang pekerjaan dari awal alih-alih melanjutkan dari tempat pekerjaan ditinggalkan seperti biasa. Namun, ini juga akan mengurangi jumlah bit tulis disk selama masa pakai pekerjaan, yang dapat meningkatkan performa untuk pekerjaan yang lebih kecil.

Properti ini juga menyebabkan BITS diunduh langsung ke file tujuan, alih-alih mengunduh ke file sementara dan memindahkan file sementara ke tujuan akhir setelah transfer selesai. Ini berarti bahwa BITS tidak akan membersihkan konten yang diunduh sebagian jika pekerjaan dibatalkan atau mengalami kondisi kesalahan yang fatal; pemanggil BITS bertanggung jawab untuk membersihkan file tujuan, jika dibuat. Namun, itu juga akan sedikit mengurangi overhead disk.

Properti ini hanya direkomendasikan untuk skenario yang melibatkan jumlah pekerjaan kecil yang tinggi (di bawah 1MB) dan yang tidak memerlukan keandalan untuk kehilangan daya atau peristiwa pematian tak terduga lainnya. Penghematan performa umumnya tidak signifikan untuk sejumlah kecil pekerjaan atau untuk pekerjaan yang lebih besar.

Properti ini menggunakan bidang AktifkanBITS_JOB_PROPERTY_VALUE. Properti ini hanya didukung untuk pekerjaan BG_JOB_TYPE_DOWNLOAD . Properti ini hanya dapat diatur sebelum menambahkan file apa pun ke pekerjaan.
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
Nilai: 5
ID untuk menandai jumlah maksimum byte pekerjaan BITS akan diizinkan untuk diunduh secara total. Properti ini ditujukan untuk digunakan dengan BITS_JOB_PROPERTY_DYNAMIC_CONTENT, di mana Anda mungkin tidak dapat menentukan ukuran file yang akan diunduh sebelumnya tetapi ingin membatasi total kemungkinan ukuran unduhan.

Properti ini menggunakan bidang AktifkanBITS_JOB_PROPERTY_VALUE. Properti ini hanya didukung untuk pekerjaan BG_JOB_TYPE_DOWNLOAD . Properti ini hanya dapat diatur sebelum pertama kalinya Resume dipanggil pada pekerjaan.
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
Nilai: 7
ID untuk menandai pekerjaan BITS bersedia menyertakan kredensial default dalam permintaan ke server proksi. Mengaktifkan properti ini setara dengan mengatur tingkat keamanan WinHTTPWINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM atas permintaan yang dilakukan BITS atas nama pengguna. BITS pengguna mengambil kredensial yang disimpan dari sama dengan yang membuat permintaan jaringan atas nama: BITS biasanya akan menggunakan kredensial pemilik pekerjaan, kecuali Anda telah secara eksplisit memberikan token pembantu jaringan, dalam hal ini BITS akan menggunakan kredensial token pembantu jaringan.

Properti ini menggunakan bidang TargetBITS_JOB_PROPERTY_VALUE. Namun, hanya target BG_AUTH_TARGET_PROXY yang didukung.
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
Nilai: 9
ID yang digunakan untuk mengontrol waktu pemberitahuan BITS JobNotification dan FileRangesTransferred . Mengaktifkan properti ini memungkinkan pengguna diberi tahu pada tingkat yang berbeda. Properti ini dapat diubah saat transfer sedang berlangsung; namun, tarif baru mungkin tidak segera diterapkan. Nilai defaultnya adalah 500 milidetik.

Properti ini menggunakan bidang DWORDBITS_JOB_PROPERTY_VALUE.
BITS_JOB_PROPERTY_ON_DEMAND_MODE
Nilai: 10
ID yang digunakan untuk mengontrol apakah pekerjaan berada dalam mode Sesuai Permintaan. Pekerjaan Sesuai Permintaan memungkinkan aplikasi untuk meminta rentang tertentu untuk unduhan file alih-alih mengunduh dari awal hingga akhir. Nilai defaultnya adalah FALSE; pekerjaan ini tidak sesuai permintaan. Rentang diminta menggunakan metode IBackgroundCopyFile6::RequestFileRanges .

Properti ini menggunakan bidang AktifkanBITS_JOB_PROPERTY_VALUE.

Persyaratan untuk pekerjaan BITS_JOB_PROPERTY_ON_DEMAND_MODE adalah bahwa transfer harus merupakan pekerjaan BG_JOB_TYPE_DOWNLOAD . Pekerjaan tidak boleh DINAMIS dan server harus server HTTP atau HTTPS dan persyaratan server untuk dukungan rentang semuanya harus dipenuhi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Server minimum yang didukung Windows Server 2012
Header bits5_0.h

Lihat juga