共用方式為

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

另請參閱

IBackgroundCopyFile6