共用方式為


IBackgroundCopyJob::Cancel 方法(bits.h)

從傳輸佇列中刪除該工作,並移除用戶端(下載)和伺服器(上傳)的相關暫存檔案。

語法

HRESULT Cancel();

返回值

此方法回傳以下 HRESULT 值及其他值。

回傳碼 Description
S_OK
工作成功取消了。
BG_S_UNABLE_TO_DELETE_FILES
該工作成功取消;然而,該服務無法刪除與該工作相關的暫存檔案。
BG_E_INVALID_STATE
不能取消州內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

另請參閱

IBackgroundCopyJob::完成

IBackgroundCopyJob::履歷

IBackgroundCopyJob::暫停