Metode IBackgroundCopyCallback3::FileRangesTransferred (bits10_1.h)

Artikel
02/23/2024

BITS memanggil implementasi metode FileRangesTransferred Anda ketika satu atau beberapa rentang file telah diunduh. Rentang file ditambahkan ke pekerjaan menggunakan metode IBackgroundCopyFile6::RequestFileRanges .

Sintaks

HRESULT FileRangesTransferred(
  IBackgroundCopyJob     *job,
  IBackgroundCopyFile    *file,
  DWORD                  rangeCount,
  const BG_FILE_RANGE [] ranges
);

Parameter

job

Objek IBackgroundCopyJob yang berisi metode untuk mengakses informasi properti, kemajuan, dan status pekerjaan. Jangan melepaskan pJob; BITS merilis antarmuka saat metode kembali.

file

Objek IBackgroundCopyFile yang berisi informasi tentang file yang rentangnya telah berubah. Jangan melepaskan pFile; BITS merilis antarmuka saat metode kembali.

rangeCount

Jumlah entri dalam array rentang.

ranges

Array rentang file yang telah ditransfer sejak panggilan terakhir ke FileRangesTransferred atau panggilan terakhir ke metode IBackgroundCopyFile6::RequestFileRanges . Jangan rentang bebas; BITS membebaskan memori rentang saat metode FileRangesTransferred kembali.

Mengembalikan nilai

Metode ini mengembalikan S_OK pada keberhasilan; jika tidak, mengembalikan kode kesalahan.

Keterangan

Rentang yang dikembalikan dalam metode ini mungkin tidak cocok dengan rentang yang Anda minta. Ini karena BITS tidak akan mengunduh rentang byte yang sama dua kali, dan karena BITS dapat melaporkan ketika bagian dari rentang diunduh.

Implementasi Anda mungkin tidak menerima semua peristiwa modifikasi dalam kondisi beban sumber daya maksimum.

BITS menghasilkan volume peristiwa yang tinggi; pertimbangkan untuk membuat timer dan polling untuk informasi status dan kemajuan atau membatasi penggunaan panggilan balik ini. Jika Anda menggunakan panggilan balik ini, jaga agar implementasi Anda tetap singkat. Anda harus mengatur properti BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL ke nilai tertinggi yang masih memenuhi kebutuhan Anda; ini akan mengurangi jumlah panggilan balik yang tidak perlu.

Catatan BITS mendukung hingga empat pemberitahuan simultan per pengguna. Jika satu atau beberapa aplikasi memblokir keempat pemberitahuan untuk pengguna agar tidak kembali, aplikasi yang berjalan sebagai pengguna yang sama tidak akan menerima pemberitahuan hingga satu atau beberapa pemberitahuan pemblokiran kembali.

Contoh

Untuk contoh cara menggunakan fungsi ini, lihat contoh kode untuk antarmuka IBackgroundCopyCallback3 .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	bits10_1.h (termasuk Bits.h)
Pustaka	Bits.lib

Lihat juga

IBackgroundCopyCallback3

Bagikan melalui