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

> IXtfDeployCallback::OnDeployFileProgress

# IXtfDeployCallback::OnDeployFileProgress

叫用以回報將檔案部署至主機之進度的回呼。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
public:
HRESULT OnDeployFileProgress(
         LPCWSTR pszFilePath,
         ULONGLONG ullBytesTransferred,
         ULONGLONG ullFileSize
)  
```

<a id="parametersSection" />

### 參數

*pszFilePath*\
類型：LPCWSTR

正在部署之檔案的路徑。

*ullBytesTransferred*\
類型：ULONGLONG

到目前為止已傳輸的位元組數目。

*ullFileSize*\
類型：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)。

<Note>部署的檔案傳輸程序會使用多個執行緒。您的程式碼必須確保依 `pszFilePath` 關聯進度訊息，並防範一般的多執行緒問題。</Note>

與 `IXtfDeployCallback` 的其他回呼相同，如果此回呼傳回 `S_OK`，部署程序就會繼續。如果此回呼傳回任何 `HRESULT` 錯誤碼，部署程序就會立即取消。已傳輸或已刪除的檔案會維持原狀，而部分傳輸的檔案則會以截斷的形式關閉。必須再完成一次部署，才能確保主機上的所有檔案都完整且為最新狀態。

## 需求

**標頭：** xtfapplication.h

**程式庫：** xtfapplication.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[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::OnDeployExtraFileDetected](/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.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)