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 を含む)
Library	Bits.lib

こちらもご覧ください

IBackgroundCopyFile6