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

# OnDeployInitialized

> IXtfDeployCallback::OnDeployInitialized 方法

# IXtfDeployCallback::OnDeployInitialized 方法

部署開始時叫用的回呼。

## 語法

```cpp theme={null}
public:
HRESULT OnDeployInitialized()  
```

### 傳回值

類型：HRESULT

傳回 `S_OK` 以繼續部署，或傳回 HRESULT 錯誤碼以取消部署。

## 備註

此回呼會叫用一次，表示部署系統已成功初始化並開始部署程序。如果您的程式碼需要儲存開始時間以測量部署時間，或需要初始化進度對話方塊，這裡是執行這些動作的好地方。如需在部署程序期間何時叫用回呼的詳細資訊，請參閱 [IXtfDeployCallback 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md)。

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

## 需求

**標頭：** xtfapplication.h

**程式庫：** xtfapplication.lib

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

## 另請參閱

[IXtfDeployCallback 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfDeployCallback 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md)
- [Deploy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [HCIsInitialized](https://docs.xbox.com/zh-TW/reference/live/httpclient/httpclient/functions/hcisinitialized.md)
- [DeployEx](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)
- [OnDeployMetrics](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)