> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfDeployCallback::OnDeployChangeEvaluation

> IXtfDeployCallback::OnDeployChangeEvaluation

# IXtfDeployCallback::OnDeployChangeEvaluation

在评估哪些文件需要传输或删除时调用的回调。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
public:
HRESULT OnDeployChangeEvaluation(
         ULONGLONG ullFilesProcessed,
         ULONGLONG ullTotalFiles
)  
```

<a id="parametersSection" />

### 参数

*ullFilesProcessed*\
类型：ULONGLONG

到目前为止已评估的文件数。

*ullTotalFiles*\
类型：ULONGLONG

要评估的文件总数。

<a id="retvalSection" />

### 返回值

类型：HRESULT

返回 `S_OK` 以继续部署，或返回 HRESULT 错误代码以取消部署。

<a id="remarksSection" />

## 备注

此回调在部署系统评估哪些文件需要部署到主机或从主机删除时调用。你可以使用此回调更新进度指示器。有关文件如何评估以及在部署过程中何时调用回调的详细信息，请参阅 [IXtfDeployCallback Interface](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)。

与 `IXtfDeployCallback` 的其他回调一样，如果此回调返回 `S_OK`，则部署过程继续。如果此回调返回任何 `HRESULT` 错误代码，则部署过程会立即取消。已传输或删除的文件保持原样，部分传输的文件将以其被截断的形式关闭。必须完成另一次部署，以确保主机上的所有文件完整且为最新。

如果你正在部署尚未在目标主机上注册的游戏或应用，则必须部署所有文件，此回调根本不会被调用。

<a id="requirementsSection" />

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

<a id="seealsoSection" />

## 另请参阅

[IXtfDeployCallback Interface](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployError](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)
- [IXtfDeployCallback::OnDeployMetrics method](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployFileProgress](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployInitialized Method](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [IXtfDeployCallback::OnDeployExtraFileDetected](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md)