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 [仅限桌面应用] |
标头 |
|