從傳輸佇列中刪除該工作,並移除用戶端(下載)和伺服器(上傳)的相關暫存檔案。
語法
HRESULT Cancel();
返回值
此方法回傳以下 HRESULT 值及其他值。
| 回傳碼 | Description |
|---|---|
|
工作成功取消了。 |
|
該工作成功取消;然而,該服務無法刪除與該工作相關的暫存檔案。 |
|
不能取消州內BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED的工作。 |
備註
你可以隨時 取消工作 ;但該工作在被取消後無法恢復。
對於上傳工作,如果伺服器無法使用,BITS 可能會有延遲才會從隊列中刪除該工作。 BITS 會定期向 BITS 伺服器發送取消請求,期限可達 24 小時。 若伺服器在 24 小時內未回應,BITS 將該工作從隊列中移除。 若 無進度逾時 時間少於 24 小時,BITS 會利用無進度逾時限制重試次數。
取消方法會在上傳未完成時取消。 如果上傳完成且工作類型為 BG_JOB_TYPE_UPLOAD_REPLY,該方法會取消回覆。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | 視窗XP |
| 支援的最低伺服器 | Windows Server 2003 |
| 目標平臺 | 窗戶 |
| Header | Bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |