IXtfApplicationClient::DeployEx
部署指定的應用程式套件。語法
參數
pszDeployFilepath類型:LPCWSTR 要部署之內容的來源路徑。 deployTarget
類型:int 表示要部署到的磁碟機。允許的值及其意義如下:
- -1 表示由 ‘xbconfig defaultstoragedevice’ 指定的預設部署裝置。
- 0 表示使用零售磁碟機
- 1 表示在具有開發磁碟機的主機上使用開發磁碟機
- 2 表示外部磁碟機 1,3 表示外部磁碟機 2,依此類推
類型: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 deploy 命令,該工具隨附於 XBOX Tools Framework (XTF) 中。如需 xbapp deploy 命令的詳細資訊,請參閱應用程式管理 (xbapp.exe) (NDA 主題)。
處理 LPBSTR 指標
如需處理此函式所傳回之 LPBSTR 指標的詳細資訊,請參閱配置和釋放 BSTR 的記憶體。需求
標頭: xtfapplication.h 程式庫: xtfapplication.lib 支援的平台: Windows (適用於 XBOX 主機工具)另請參閱
IXtfApplicationClientXtfApplication
