IBackgroundCopyFile2::GetFileRanges メソッド

リモートファイルからダウンロードする範囲を取得します。

構文

HRESULT GetFileRanges(
  [in, out] DWORD         *RangeCount,
  [out]     BG_FILE_RANGE **Ranges
);

RangeCount [in, out]: Ranges 内の要素の数。
範囲 [out]: ダウンロード する範囲を 指定するBG_FILE_RANGE構造体の配列。完了したら、 CoTaskMemFree 関数を呼び出して Ranges を解放します。

このメソッドは、次の戻り値と他の戻り値を返します。

リターンコード	説明
S_OK	Success
S_FALSE	範囲が指定されていないか、ジョブがアップロードジョブまたはアップロード/応答ジョブです。 RangeCount が 0 に設定され、 Range が NULL に設定されています。

要件	値
サポートされている最小のクライアント	Windows 10、バージョン 1709 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server バージョン 1709 [デスクトップアプリのみ]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
ライブラリ	Dosvc.lib
[DLL]	Dosvc.dll
IID	IID_IBackgroundCopyFile2は 83e81b93-0873-474d-8a8c-f2018b1a939c として定義されています