bits.h 標頭

發行項
03/16/2023

背景智慧型傳送服務會使用此標頭。如需詳細資訊，請參閱

背景智慧型傳送服務

bits.h 包含下列程式設計介面：

介面


IBackgroundCopyCallback 實作 IBackgroundCopyCallback 介面，以接收作業已完成、已修改或發生錯誤的通知。用戶端會使用此介面，而不是輪詢作業的狀態。
IBackgroundCopyError 使用 IBackgroundCopyError 介面來判斷錯誤的原因，以及傳輸程式是否可以繼續。
IBackgroundCopyFile IBackgroundCopyFile 包含屬於作業一部分的檔案相關資訊。例如，您可以使用 IBackgroundCopyFile 方法來擷取檔案的本機和遠端名稱，並傳輸進度資訊。
IBackgroundCopyJob 使用 IBackgroundCopyJob 介面將檔案新增至作業、設定作業的優先順序層級、判斷作業的狀態，以及啟動和停止作業。
IBackgroundCopyManager 建立傳輸作業、擷取列舉值物件，其中包含佇列中的作業，並從佇列擷取個別作業。
IEnumBackgroundCopyFiles 使用 IEnumBackgroundCopyFiles 介面來列舉作業所包含的檔案。若要取得 IEnumBackgroundCopyFiles 介面指標，請呼叫 IBackgroundCopyJob：：EnumFiles 方法。
IEnumBackgroundCopyJobs 使用 IEnumBackgroundCopyJobs 介面來列舉傳輸佇列中的作業清單。若要取得 IEnumBackgroundCopyJobs 介面指標，請呼叫 IBackgroundCopyManager：：EnumJobs 方法。

結構


BG_FILE_INFO 提供要傳送之檔案的本機和遠端名稱。
BG_FILE_PROGRESS 提供檔案相關的進度資訊，例如傳輸的位元組數目。
BG_JOB_PROGRESS 提供作業相關的進度資訊，例如傳輸的位元組和檔案數目。
BG_JOB_TIMES 提供作業相關的時間戳記。

列舉


BG_ERROR_CONTEXT 定義常數，指定發生錯誤的內容。
BG_JOB_PRIORITY 定義常數，指定作業的優先順序層級。
BG_JOB_PROXY_USAGE 定義常數，指定要用於檔案傳輸的 Proxy。您可以為每個作業定義不同的 Proxy 設定。
BG_JOB_STATE 定義常數，指定作業的不同狀態。
BG_JOB_TYPE 定義常數，指定傳輸作業的類型，例如下載。