跳轉到主要內容

IXtfApplicationClient::DeployEx

部署指定的應用程式套件。

語法

參數

pszDeployFilepath
類型:LPCWSTR
要部署之內容的來源路徑。 deployTarget
類型:int
表示要部署到的磁碟機。允許的值及其意義如下:
  • -1 表示由 ‘xbconfig defaultstoragedevice’ 指定的預設部署裝置。
  • 0 表示使用零售磁碟機
  • 1 表示在具有開發磁碟機的主機上使用開發磁碟機
  • 2 表示外部磁碟機 1,3 表示外部磁碟機 2,依此類推
fRemoveExtraFiles
類型:BOOL
指定 TRUE 以移除已在開發主機上但不屬於部署套件的檔案;否則指定 FALSE 以保留這些檔案。 pCallback
類型:IXtfDeployCallback*
指向在部署期間發生可追蹤動作時要叫用之 IXtfDeployCallback 回呼的指標。如果您不想在部署期間收到回呼,請設定為 nullptr。 pfCanceled
類型:BOOL*
指標,接收表示部署是否已取消的布林值。 pdwResult
類型:int*
指標,接收部署作業的 HRESULT。例如,如果開啟的檔案控制代碼導致無法刪除檔案,此參數會接收 HRESULT 錯誤碼。 pbstrPackageFullName
類型:LPBSTR
指標,接收已部署之應用程式套件的完整名稱,包括版本號碼、架構和文化特性。 pbstrAumidJson
類型:LPBSTR
指標,接收與應用程式套件相關聯之 AUMID 清單的 JSON 表示法。清單中的所有 AUMID 都共用相同的 PackageFamilyName,但每個 AUMID 中驚嘆號 (”!”) 之後的 AppId 各不相同。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則會傳回 HRESULT 錯誤碼。

備註

此方法會將您的遊戲推送部署至 XBOX 開發套件以進行測試。您的遊戲會部署至遊戲暫存磁碟機中 pszDeployFilepath 所指定的資料夾。方法成功完成部署之後,您的遊戲即可啟動。如需部署應用程式套件的詳細資訊,請參閱將遊戲部署至 XBOX 開發套件 (NDA 主題)。
此函式會同步執行。
此方法類似於應用程式管理 (xbapp.exe) 工具中的 xbapp deploy 命令,該工具隨附於 XBOX Tools Framework (XTF) 中。如需 xbapp deploy 命令的詳細資訊,請參閱應用程式管理 (xbapp.exe) (NDA 主題)。

處理 LPBSTR 指標

如需處理此函式所傳回之 LPBSTR 指標的詳細資訊,請參閱配置和釋放 BSTR 的記憶體。

需求

標頭: xtfapplication.h 程式庫: xtfapplication.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

IXtfApplicationClient
XtfApplication
最後修改於 2026年10月6日