IBackgroundCopyJob 介面

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

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

成員

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

方法

IBackgroundCopyJob介面具有這些方法。

方法 描述
取消 取消作業,並從用戶端移除暫存檔案。
完成 結束作業,並將傳輸的檔案儲存在用戶端上。
EnumFiles 傳回您用來列舉作業中檔案的列舉值物件的介面指標。
GetDisplayName 擷取識別作業的顯示名稱。
GetError 在發生錯誤之後,擷取錯誤物件的介面指標。
GetId 擷取佇列中作業的識別碼。
GetNoProgressTimeout 擷取傳遞優化在遇到暫時性錯誤狀況之後,繼續嘗試傳輸檔案的時間長度。
GetNotifyFlags 擷取您為應用程式設定的事件通知 (回呼) 旗標。
GetNotifyInterface 擷取 IBackgroundCopyCallback 介面實作的指標, (回呼) 。
GetPriority 擷取您已為作業設定的優先順序層級。
GetProgress 擷取作業相關的進度資訊,例如傳送至用戶端的位元組和檔案數目。
GetState 擷取作業的狀態。
GetTimes 擷取與作業相關的啟用時間戳,例如建立作業的時間。
GetType 擷取正在執行的傳輸類型,例如檔案下載。
繼續 啟動新的作業,或重新開機暫停的作業。
SetNoProgressTimeout 指定傳遞優化在遇到暫時性錯誤狀況之後,繼續嘗試傳輸檔案的時間長度。
SetNotifyFlags 指定要接收的事件通知類型。
SetNotifyInterface 指定 IBackgroundCopyCallback 介面實作的指標, (回呼) 。 介面會根據您設定的事件通知旗標來接收通知。
SetPriority 指定相對於傳輸佇列中其他作業的作業優先順序。
暫止 暫停作業。

規格需求

需求
最低支援的用戶端
Windows 10版本 1709 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 版本 1709 [僅限傳統型應用程式]
標頭
Deliveryoptimization.h
Idl
DeliveryOptimization.idl
程式庫
Dosvc.lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob定義為 37668D37-507E-4160-9316-26306D150B12

另請參閱

IBackgroundCopyFile

IBackgroundCopyManager