IBackgroundCopyFile6::UpdateDownloadPosition メソッド (bits10_1.h)
不足しているデータのダウンロードに優先順位を付ける位置を指定します。
構文
HRESULT UpdateDownloadPosition(
[in] UINT64 offset
);
パラメーター
[in] offset
不足しているデータのダウンロードに優先順位を付ける新しい位置を指定します。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 ジョブがBITS_JOB_PROPERTY_ON_DEMAND_MODE ジョブの要件を満たしていない場合は、BG_E_RANDOM_ACCESS_NOT_SUPPORTEDが返されます。
注釈
UpdateDownloadPosition は、 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 を含む) |
| Library | Bits.lib |