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 [僅限傳統型應用程式] |
標頭 |
|
Idl |
|
程式庫 |
|
DLL |
|
IID |
IID_IBackgroundCopyJob定義為 37668D37-507E-4160-9316-26306D150B12 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應