共用方式為

IBackgroundCopyFile6：：RequestFileRanges 方法 (bits10_1.h)

  • 發行項

新增一組要優先下載的檔案範圍。

語法

HRESULT RequestFileRanges(
  [in] DWORD                  rangeCount,
  [in] const BG_FILE_RANGE [] ranges
);

參數

[in] rangeCount

指定 Ranges 陣列的大小。

[in] ranges

要下載的檔案範圍陣列。 允許要求的範圍重疊先前下載的 (或擱置) 範圍。 範圍會自動分割成非重疊的範圍。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。 如果要求範圍的任何部分超出實際檔案大小，則會傳回BG_E_INVALID_RANGE;如果作業不是下載作業，或伺服器失去支援下載範圍的能力，則會傳回BG_E_RANDOM_ACCESS_NOT_SUPPORTED。

備註

RequestFileRanges 可以要求任何也符合 BITS_JOB_PROPERTY_ON_DEMAND_MODE 作業需求的下載作業。

BITS_JOB_PROPERTY_ON_DEMAND_MODE作業的需求是傳輸必須是 DOWNLOAD 作業。 此作業不得為 DYNAMIC ，而且伺服器必須是 HTTP 或 HTTPS 伺服器，而且必須符合範圍支援的伺服器需求。 如需詳細資訊，請參閱 BITS 下載的 HTTP 需求。

下載所有要求的範圍時，如果已傳輸檔案的所有位元組，工作狀態就會設定為 BG_JOB_STATE_TRANSFERRED 。 否則，作業狀態會設定為 BG_JOB_STATE_SUSPENDED。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1703 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 bits10_1.h (包含 Bits.h)
程式庫 Bits.lib

另請參閱

IBackgroundCopyFile6