IXtfApplicationClient::Deploy

指定したアプリ パッケージを配置します。

構文

public:
HRESULT Deploy(
         LPCWSTR pszDeployFilepath,
         BOOL fRemoveExtraFiles,
         IXtfDeployCallback *pCallback,
         BOOL *pfCanceled,
         int *pdwResult,
         LPBSTR pbstrPackageFullName,
         LPBSTR pbstrAumidJson
)  

パラメーター

pszDeployFilepath
型: LPCWSTR

デプロイされるコンテンツのソース パス。

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 トピック)認可が必須です」を参照してください。

注意

この関数は同期的に実行されます。

このメソッドは、Xbox Tools Framework (XTF) の一部として含まれているアプリケーション管理 (xbapp.exe) ツールの xbapp deploy コマンドに似ています。 xbapp deploy コマンドの詳細については、「アプリケーション管理 (xbapp.exe) (NDA トピック)認可が必須です」を参照してください。

LPBSTR ポインターの処理

この関数によって返される LPBSTR ポインターの処理の詳細については、BSTR のメモリの割り当てと解放に関するページを参照してください。

要件

ヘッダー: xtfapplication.h

ライブラリ: xtfapplication.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

IXtfApplicationClient
XtfApplication