BG_FILE_PROGRESS 結構

  • 發行項

BG_FILE_PROGRESS結構提供檔案相關的進度資訊，例如傳輸的位元組數目。

語法

typedef struct _BG_FILE_PROGRESS {
  UINT64 BytesTotal;
  UINT64 BytesTransferred;
  BOOL   Completed;
} BG_FILE_PROGRESS;

成員

BytesTotal

檔案大小，以位元組為單位。 例如，如果傳遞優化無法判斷檔案的大小 (，如果檔案或伺服器不存在) ，則會DO_UNKNOWN_FILE_SIZE值。

如果您要從檔案下載範圍， BytesTotal 會反映您想要從檔案下載的位元組總數。

BytesTransferred

傳輸的位元組數目。

Completed

針對下載，如果檔案可供使用者使用，則值為 TRUE ;否則，此值為 FALSE。 呼叫 IBackgroundCopyJob：：Complete 方法之後，檔案可供使用者使用。 如果 Complete 方法產生暫時性錯誤，這些檔案會在發生錯誤之前處理，可供使用者使用;其他不是。 使用 Completed 成員來判斷 完成 失敗時，檔案是否可供使用者使用。

備註

若要判斷傳遞優化是否已傳輸檔案，您可以：

  • 比較 BytesTransferred 與 BytesTotal。

規格需求

需求 值
最低支援的用戶端
 Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 版本 1709 [僅限傳統型應用程式]
標頭
Deliveryoptimization.h

另請參閱

BG_JOB_PROGRESS

IBackgroundCopyFile：：GetProgress