BG_FILE_PROGRESS 結構 (bits.h)

發行項
03/05/2024

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

語法

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

成員

BytesTotal

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

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

BytesTransferred

傳輸的位元元組數目。

Completed

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

對於上傳，當檔案上傳完成時，此值為 TRUE ;否則，此值為 FALSE。