IBackgroundCopyFile6：：GetFilledFileRanges 方法 (bits10_1.h)
傳回已下載的檔案範圍集合。
語法
HRESULT GetFilledFileRanges(
[out] DWORD *rangeCount,
[out] BG_FILE_RANGE **ranges
);
參數
[out] rangeCount
Ranges 中的項目數目。
[out] ranges
描述已下載之範圍的 BG_FILE_RANGE 結構的陣列。 範圍會盡可能合併在一起。 範圍會依位移排序。 完成時，呼叫 CoTaskMemFree 函式以釋放 Ranges。
傳回值
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如果無法配置 Ranges 陣列 BG_E_RANDOM_ACCESS_NOT_SUPPORTED，而且如果作業不是下載作業，或伺服器失去支援下載範圍的能力，就會E_OUTOFMEMORY錯誤。
備註
GetFilledFileRanges 可以要求任何也符合 BITS_JOB_PROPERTY_ON_DEMAND_MODE 作業需求的下載作業。
BITS_JOB_PROPERTY_ON_DEMAND_MODE作業的需求是傳輸必須是 DOWNLOAD 作業。 此作業不得為 DYNAMIC ，而且伺服器必須是 HTTP 或 HTTPS 伺服器，而且必須符合範圍支援的伺服器需求。 如需詳細資訊，請參閱 BITS 下載的 HTTP 需求。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1703 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | bits10_1.h (包含 Bits.h) |
| 程式庫 | Bits.lib |