IBackgroundCopyJob 介面 (bits.h)

使用 IBackgroundCopyJob 介面將檔案新增至作業、設定作業的優先順序層級、判斷作業的狀態,以及啟動和停止作業。

若要建立作業,請呼叫 IBackgroundCopyManager::CreateJob 方法。 若要取得現有作業的 IBackgroundCopyJob 介面指標,請呼叫 IBackgroundCopyManager::GetJob 方法。

繼承

IBackgroundCopyJob 介面繼承自 IUnknown 介面。 IBackgroundCopyJob 也有下列類型的成員:

方法

IBackgroundCopyJob 介面具有這些方法。

 
IBackgroundCopyJob::AddFile

將單一檔案新增至作業。
IBackgroundCopyJob::AddFileSet

將多個檔案新增至作業。
IBackgroundCopyJob::Cancel

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

結束作業,並將傳輸的檔案儲存在用戶端上。
IBackgroundCopyJob::EnumFiles

擷取您用來列舉作業中檔案的 IEnumBackgroundCopyFiles 介面指標。
IBackgroundCopyJob::GetDescription

擷取作業的描述。
IBackgroundCopyJob::GetDisplayName

擷取作業的顯示名稱。 一般而言,您會使用顯示名稱來識別使用者介面中的作業。
IBackgroundCopyJob::GetError

在發生錯誤之後擷取錯誤介面。
IBackgroundCopyJob::GetErrorCount

擷取嘗試傳輸作業的BITS次數,併發生錯誤。
IBackgroundCopyJob::GetId

擷取用來識別佇列中作業的標識碼。
IBackgroundCopyJob::GetMinimumRetryDelay

擷取服務在嘗試傳輸檔案之前遇到暫時性錯誤狀況之後等候的時間長度下限。
IBackgroundCopyJob::GetNoProgressTimeout

擷取服務嘗試在發生暫時性錯誤狀況之後傳輸檔案的時間長度。 如果有進度,則會重設定時器。
IBackgroundCopyJob::GetNotifyFlags

擷取作業的事件通知旗標。
IBackgroundCopyJob::GetNotifyInterface

擷取 IBackgroundCopyCallback 介面實作的介面指標。
IBackgroundCopyJob::GetOwner

擷取作業擁有者的身分識別。
IBackgroundCopyJob::GetPriority

擷取作業的優先順序層級。 優先順序層級會決定作業的處理時間,相對於傳輸佇列中的其他作業。
IBackgroundCopyJob::GetProgress

擷取作業相關的進度資訊,例如傳輸的位元組和檔案數目。
IBackgroundCopyJob::GetProxySettings

擷取作業用來傳輸檔案的 Proxy 資訊。
IBackgroundCopyJob::GetState

擷取作業的狀態。
IBackgroundCopyJob::GetTimes

擷取作業相關的時間戳,例如建立作業或上次修改的時間。
IBackgroundCopyJob::GetType

擷取正在執行的傳輸類型,例如檔案下載或上傳。
IBackgroundCopyJob::Resume

啟動新的作業,或重新啟動已暫停的作業。
IBackgroundCopyJob::SetDescription

提供作業的描述。
IBackgroundCopyJob::SetDisplayName

指定作業的顯示名稱。 一般而言,您會使用顯示名稱來識別使用者介面中的作業。
IBackgroundCopyJob::SetMinimumRetryDelay

設定 BITS 在嘗試傳輸檔案之前遇到暫時性錯誤狀況之後等候的時間長度下限。
IBackgroundCopyJob::SetNoProgressTimeout

設定 BITS 在發生暫時性錯誤狀況之後嘗試傳輸檔案的時間長度。 如果有進度,則會重設定時器。
IBackgroundCopyJob::SetNotifyFlags

指定您想要接收的事件通知類型,例如作業傳輸的事件。
IBackgroundCopyJob::SetNotifyInterface

識別對 BITS 的 IBackgroundCopyCallback 介面實作。 使用IBackgroundCopyCallback 介面來接收作業相關事件的通知。
IBackgroundCopyJob::SetPriority

指定作業的優先順序層級。 優先順序層級會決定您的作業何時相對於傳輸佇列中的其他作業進行處理。
IBackgroundCopyJob::SetProxySettings

指定要用來傳輸檔案的 Proxy。
IBackgroundCopyJob::Suspend

暫停作業。 新的作業、發生錯誤的作業,以及已完成傳輸檔案的工作會自動暫停。
IBackgroundCopyJob::TakeOwnership

將作業的擁有權變更為目前使用者。

規格需求

需求
最低支援的用戶端 Windows XP
最低支援的伺服器 Windows Server 2003
目標平台 Windows
標頭 bits.h

另請參閱

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs