Metode IBackgroundCopyFile6::RequestFileRanges (bits10_1.h)
Menambahkan sekumpulan rentang file baru yang akan diprioritaskan untuk diunduh.
Sintaks
HRESULT RequestFileRanges(
[in] DWORD rangeCount,
[in] const BG_FILE_RANGE [] ranges
);
Parameter
[in] rangeCount
Menentukan ukuran array Rentang .
[in] ranges
Array rentang file yang akan diunduh. Rentang yang diminta diizinkan untuk tumpang tindih dengan rentang yang diunduh sebelumnya (atau tertunda). Rentang secara otomatis dibagi menjadi rentang yang tidak tumpang tindih.
Menampilkan nilai
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. BG_E_INVALID_RANGE dikembalikan jika ada bagian dari rentang yang diminta berada di luar ukuran file aktual; BG_E_RANDOM_ACCESS_NOT_SUPPORTED dikembalikan jika pekerjaan bukan pekerjaan pengunduhan atau jika server kehilangan kemampuannya untuk mendukung rentang unduhan.
Keterangan
RequestFileRanges dapat diminta untuk pekerjaan pengunduhan apa pun yang juga memenuhi persyaratan untuk pekerjaan BITS_JOB_PROPERTY_ON_DEMAND_MODE .
Persyaratan untuk pekerjaan BITS_JOB_PROPERTY_ON_DEMAND_MODE adalah bahwa transfer harus berupa pekerjaan DOWNLOAD . Pekerjaan tidak boleh DINAMIS dan server harus server HTTP atau HTTPS dan persyaratan server untuk dukungan rentang semuanya harus dipenuhi. Untuk informasi selengkapnya, lihat Persyaratan HTTP untuk Unduhan BITS.
Ketika semua rentang yang diminta telah diunduh, status pekerjaan akan diatur ke BG_JOB_STATE_TRANSFERRED jika semua byte file telah ditransfer. Jika tidak, status pekerjaan akan diatur ke BG_JOB_STATE_SUSPENDED.
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 |