將檔案新增至下載作業，並指定您要下載的檔案範圍。
語法
HRESULT AddFileWithRanges(
[in] LPCWSTR fileId,
[in] LPCWSTR remoteUrl,
[in] LPCWSTR localName,
[in, optional] DWORD rangeCount,
[in, optional] BG_FILE_RANGE ranges[],
[in, optional] ULONG64 fileSize
);
參數
-
fileId [in]
-
Null 終止的字串，為已發佈內容的唯一識別碼。 對於非已發佈的內容，這可以是呼叫端可用來識別作業內檔案的任何唯一字串。
-
remoteUrl [in]
-
Null 終止的字串，其中包含伺服器上的檔案名。
-
localName [in]
-
Null 終止的字串，其中包含用戶端上的檔案名。
-
rangeCount [in， optional]
-
Ranges中的元素數目。
-
範圍 [in， 選擇性]
-
指定要下載範圍的一或多個 BG_FILE_RANGE 結構的陣列。 請勿指定重複或重迭的範圍。
-
fileSize [in， optional]
-
檔案大小，以位元組為單位。 如果呼叫端應用程式不知道大小，請傳入 DO_UNKNOWN_FILE_SIZE 。
傳回值
這個方法會傳回下列傳回值，以及其他傳回值。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
本機檔案名為 Null 或空字串。 |
|
使用者沒有寫入用戶端上指定目錄的許可權。 |
|
其中一個範圍無效。 例如，InitialOffset 設定為 BG_LENGTH_TO_EOF。 |
|
DO_E_OVERLAPPING_RANGES |
您無法指定重複或重迭的範圍。 注意： 範圍會依值的位移排序，而不是長度。 如果輸入的範圍具有相同位移，但順序相反，則會傳回此錯誤。 例如，如果以該順序輸入 100.5 和 100.0，您將無法將檔案新增至作業。 |
|
作業的狀態不能 BG_JOB_STATE_CANCELLED 或 BG_JOB_STATE_ACKNOWLEDGED。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 10版本 1709 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 版本 1709 [僅限傳統型應用程式] |
| 標頭 |
|
| Idl |
|
| 媒體櫃 |
|
| DLL |
|
| IID |
IID_IDeliveryOptimizationJob定義為 EE2584CF-A69C-4848-B633-2649962B3EF7 |