> ## 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 介面](/zh-TW/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 介面](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/zh-TW/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployError](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)
- [IXtfDeployCallback::OnDeployInitialized 方法](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [IXtfDeployCallback::OnDeployMetrics 方法](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployFileProgress](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployExtraFileRemoved](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)