BG_FILE_PROGRESS 结构 (bits.h)

项目
02/28/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。