IBackgroundCopyJob::Cancel 方法 (bits.h)

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

Syntax

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 會使用無進度逾時期間來限制重試。

Cancel 方法會在上傳未完成時取消上傳。 如果上傳已完成,且作業的類型為 BG_JOB_TYPE_UPLOAD_REPLY,此方法會取消回復。

規格需求

需求
最低支援的用戶端 Windows XP
最低支援的伺服器 Windows Server 2003
目標平台 Windows
標頭 bits.h
程式庫 Bits.lib
Dll QmgrPrxy.dll

另請參閱

IBackgroundCopyJob::Complete

IBackgroundCopyJob::Resume

IBackgroundCopyJob::Suspend