IBackgroundCopyJob::Cancel 方法 (bits.h)
從傳輸佇列中刪除作業,並從用戶端 (下載) 和伺服器 (上傳) 移除相關的暫存盤。
Syntax
HRESULT Cancel();
傳回值
這個方法會傳回下列 HRESULT 值,以及其他值。
傳回碼 | Description |
---|---|
|
已成功取消作業。 |
|
已成功取消作業;不過,服務無法刪除與作業相關聯的暫存盤。 |
|
無法取消狀態為BG_JOB_STATE_CANCELLED或BG_JOB_STATE_ACKNOWLEDGED的作業。 |
備註
您可以隨時 取消作業 ;不過,取消作業之後就無法復原。
對於上傳作業,如果伺服器無法使用,BITS 可能會延遲從佇列中刪除作業。 BITS 會定期將取消要求傳送給 BITS 伺服器,最多 24 小時。 如果伺服器未在 24 小時期間內回應,BITS 會從佇列中移除作業。 如果 無進度逾時期間 小於 24 小時,BITS 會使用無進度逾時期間來限制重試。
Cancel 方法會在上傳未完成時取消上傳。 如果上傳已完成,且作業的類型為 BG_JOB_TYPE_UPLOAD_REPLY,此方法會取消回復。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP |
最低支援的伺服器 | Windows Server 2003 |
目標平台 | Windows |
標頭 | bits.h |
程式庫 | Bits.lib |
Dll | QmgrPrxy.dll |