IXtfDeployCallback Interface
提供一个回调,在 IXtfApplicationClient::Deploy 操作期间发生可跟踪操作时调用。语法
方法
备注
所有回调方法在返回值方面的工作方式都相同。如果回调返回成功的 HResult,则部署过程继续。如果回调返回任何失败的 HResult,则部署过程会立即取消。已传输或删除的文件保持原样,部分传输的文件将以其被截断的形式关闭。 回调过程很简单。开发 PC 上的每个部署文件都与目标主机上对应的文件进行比较。- 如果 PC 和主机上的文件相同,则不执行任何操作。
- 如果 PC 上的文件比主机上的文件更新,则会将该文件从 PC 复制到主机。
- 如果文件存在于 PC 但不在主机上,则会将其复制到主机。
- 如果文件存在于主机但不在 PC 上,则可选择性地从主机中删除。(是否删除由 Deploy 的 fRemoveExtraFiles 参数的值决定)。
- OnDeployInitialized:此回调在部署系统已启动时调用,可用于开始为部署计时或初始化进度对话框。当调用此回调时,所有潜在的互操作和 DLL 边界跨越都已成功完成。此回调在每次部署中调用一次。
- OnDeployChangeEvaluation:此回调在部署系统评估哪些文件需要部署到主机或从主机删除时调用。你可以使用此回调更新进度指示器。
- OnDeployMetrics:此回调在评估过程结束时调用一次,以报告将部署到主机的文件数和要传输的总字节数。
- OnDeployFileProgress:此回调在每次成功传输一个缓冲区块时(按文件)调用。传输在多个线程上同时执行,因此你的代码必须确保按文件名跟踪进度,并防范常见的多线程问题。此回调在传输开始时调用一次,在传输结束时调用一次,因此长度为零的文件会导致此回调被调用两次。
- OnDeployExtraFileDetected:指示在主机上找到了 PC 上没有的文件。
- OnDeployExtraFileRemoved:如果 Deploy 的 fRemoveExtraFiles 参数设置为 TRUE,则在从主机中删除文件时调用此回调。
- OnDeployError 不在当前实现中使用,但保留供未来使用。
