Metode IBackgroundCopyFile6::GetFilledFileRanges (bits10_1.h)
Mengembalikan kumpulan rentang file yang telah diunduh.
Sintaks
HRESULT GetFilledFileRanges(
[out] DWORD *rangeCount,
[out] BG_FILE_RANGE **ranges
);
Parameter
[out] rangeCount
Jumlah elemen dalam Rentang.
[out] ranges
Array struktur BG_FILE_RANGE yang menjelaskan rentang yang telah diunduh. Rentang akan digabungkan bersama-sama sebanyak mungkin. Rentang diurutkan berdasarkan offset. Setelah selesai, panggil fungsi CoTaskMemFree ke Rentang bebas.
Menampilkan nilai
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Kesalahan akan E_OUTOFMEMORY jika array Rentang tidak dapat dialokasikan dan BG_E_RANDOM_ACCESS_NOT_SUPPORTED jika pekerjaan tersebut bukan pekerjaan pengunduhan atau jika server kehilangan kemampuannya untuk mendukung rentang unduhan.
Keterangan
GetFilledFileRanges dapat diminta untuk pekerjaan unduhan 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 merupakan 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.
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 |