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 |