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

传输的字节数。

已完成

对于下载，如果文件可供用户使用，则值为 TRUE ;否则，值为 FALSE。 调用 IBackgroundCopyJob：：Complete 方法后，用户可以使用文件。 如果 Complete 方法生成暂时性错误，则用户可以使用错误发生前处理的这些文件;其他则不是。 使用 Completed 成员确定 完成失败时 文件是否可供用户使用。

备注

若要确定传递优化是否传输了文件，可以：

  • 比较 BytesTransferred 和 BytesTotal。

要求

要求 值
最低受支持的客户端
 Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器
 Windows Server 版本 1709 [仅限桌面应用]
标头
Deliveryoptimization.h

请参阅

BG_JOB_PROGRESS

IBackgroundCopyFile：：GetProgress