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 の感嘆符 (「!」) の後の AppIds が異なります。
戻り値
型: HRESULT 成功した場合はS_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説
このメソッドは、テスト用に XBOX 開発キットにタイトルをプッシュ デプロイします。 タイトルは、pszDeployFilepath で指定されたフォルダーのタイトル スクラッチ ドライブにデプロイされます。 メソッドがデプロイを正常に完了した後、タイトルは起動する準備が整います。 アプリ パッケージのデプロイの詳細については、XBOX 開発キットへのタイトルのデプロイ (NDA トピック) を参照してください。
この関数は同期的に実行されます。
xbapp deploy コマンドに似ています。 xbapp deploy コマンドの詳細については、アプリケーション管理 (xbapp.exe) (NDA トピック) を参照してください。
LPBSTR ポインターの処理
この関数によって返される LPBSTR ポインターの処理の詳細については、BSTR のメモリの割り当てと解放 を参照してください。要件
ヘッダー: xtfapplication.h ライブラリ: xtfapplication.lib サポートされているプラットフォーム: Windows (XBOX 本体ツール用)関連項目
IXtfApplicationClientXtfApplication