> ## 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::OnDeployExtraFileDetected

> IXtfDeployCallback::OnDeployExtraFileDetected

# IXtfDeployCallback::OnDeployExtraFileDetected

偵測到額外檔案時叫用的回呼。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
public:
HRESULT OnDeployExtraFileDetected(
         LPCWSTR pszFilePath
)  
```

<a id="parametersSection" />

### 參數

*pszFilePath*\
類型：LPCWSTR

主機上額外檔案的絕對路徑。

<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::OnDeployExtraFileRemoved](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployFileProgress](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployMetrics 方法](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [IXtfDeployCallback::OnDeployError](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)