> ## 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.

# DeployEx

> IXtfApplicationClient::DeployEx

# IXtfApplicationClient::DeployEx

指定したアプリ パッケージをデプロイします。

## 構文

```cpp theme={null}
public:
HRESULT DeployEx(
         LPCWSTR pszDeployFilepath,
         int deployTarget,
         BOOL fRemoveExtraFiles,
         IXtfDeployCallback *pCallback,
         BOOL *pfCanceled,
         int *pdwResult,
         LPBSTR pbstrPackageFullName,
         LPBSTR pbstrAumidJson
)  
```

### パラメーター

*pszDeployFilepath*\
型: LPCWSTR

デプロイするコンテンツの *ソース パス* です。

*deployTarget*\
型: int

デプロイ先のドライブを示します。 使用できる値とその意味は次のとおりです。

* -1 は、'xbconfig defaultstoragedevice' で指定されたデフォルトのデプロイ デバイスを示します。
* 0 はリテール ドライブを使用することを意味します
* 1 は開発ドライブを持つ本体で開発ドライブを使用することを意味します
* 2 は外部ドライブ 1、3 は外部ドライブ 2、以下同様に示します

*fRemoveExtraFiles*\
型: BOOL

開発本体に既に存在するがデプロイ パッケージに含まれていないファイルを削除するには TRUE を、保持するには FALSE を指定します。

*pCallback*\
型: IXtfDeployCallback\*

デプロイ中に追跡可能なアクションが発生したときに呼び出す [IXtfDeployCallback](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md) コールバックへのポインターです。 デプロイ中にコールバックが不要な場合は `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 トピック)](https://docs.xbox.com/ja-jp/home/setup-install/concepts/deployment.md) を参照してください。

> [!NOTE]
>
> この関数は同期的に実行されます。

このメソッドは、XBOX Tools Framework (XTF) の一部として含まれるアプリケーション管理 (xbapp.exe) ツールの `xbapp deploy` コマンドに似ています。 `xbapp deploy` コマンドの詳細については、[アプリケーション管理 (xbapp.exe) (NDA トピック)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbapp.md) を参照してください。

### LPBSTR ポインターの処理

この関数によって返される LPBSTR ポインターの処理の詳細については、[BSTR のメモリの割り当てと解放](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019) を参照してください。

## 要件

**ヘッダー:** xtfapplication.h

**ライブラリ:** xtfapplication.lib

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

## 関連項目

[IXtfApplicationClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfApplicationClient インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [Deploy](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XINPUT_VIBRATION_EX](https://docs.xbox.com/ja-jp/reference/input/xinputongameinput/structs/xinput_vibration_ex.md)
- [GAMEPAD_REPORT_EX](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [ListUsersEx](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)