IXtfDeployCallback::OnDeployFileProgress
为报告将文件部署到主机的进度而调用的回调。
语法
public:
HRESULT OnDeployFileProgress(
LPCWSTR pszFilePath,
ULONGLONG ullBytesTransferred,
ULONGLONG ullFileSize
)
参数
pszFilePath
类型：LPCWSTR
正在部署的文件的路径。
ullBytesTransferred
类型：ULONGLONG
到目前为止已传输的字节数。
ullFileSize
类型：ULONGLONG
正传输的文件的总大小（字节数）。
返回值
类型：HRESULT
返回 S_OK 以继续部署，或返回 HRESULT 错误代码以取消部署。
备注
部署系统将文件从部署电脑传输到控制台时，会调用此回调。 为文件成功传输的每个缓冲块都会调用一次此回调。 每次成功传输的文件中，该回调的调用次数始终至少为两次：在开始部署时和部署结束时。 如果已部署零长度文件，则两次调用都会报告零字节超出零字节。 有关如何对文件进行评估以及在部署过程中何时调用回调的详细信息，请参阅 IXtfDeployCallback 接口。
注意
用于部署的文件传输过程使用多个线程。 代码必须确保它可以通过 pszFilePath 和针对典型的多线程问题进行保护来联系进度邮件。
与 IXtfDeployCallback 的其他回调一样，如果此回调返回 S_OK，部署过程则会继续进行。 如果此回调返回任何 HRESULT 错误代码，部署过程则立即取消。 已传输或删除的文件保持原样，部分传输的文件将以其截断形式关闭。 必须完成另一个部署，以确保主机上的所有文件都完整且最新。
要求
头文件：xtfapplication.h
库：xtfapplication.lib
支持平台：Windows（适用于 Xbox 主机工具）