Share via


IBackgroundCopyFile2::GetFileRanges 方法 (bits2_0.h)

擷取您想要從遠端檔案下載的範圍。

語法

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

參數

[in, out] RangeCount

Ranges 中的項目數目。

[out] Ranges

指定要下載之範圍的 BG_FILE_RANGE 結構數位。 完成時,呼叫 CoTaskMemFree 函式以釋放 Ranges

傳回值

這個方法會傳回下列傳回值,以及其他傳回值。

傳回碼 Description
S_OK
Success
S_FALSE
未指定任何範圍,或作業是上傳或上傳-回復作業。 RangeCount 設定為零, Ranges 設定為 NULL

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP SP2、KB842773 Windows Server 2003 和 Windows XP
最低支援的伺服器 Windows Server 2008、Windows Server 2003 SP1
目標平台 Windows
標頭 bits2_0.h (包含 Bits.h)
程式庫 Bits.lib
Dll BitsPrx3.dll

另請參閱

BG_FILE_RANGE

IBackgroundCopyFile2

IBackgroundCopyJob3::AddFileWithRanges