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

こちらもご覧ください

IBackgroundCopyFile6