> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfApplicationClient::DeployToTitleScratch

> IXtfApplicationClient::DeployToTitleScratch

# IXtfApplicationClient::DeployToTitleScratch

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

<a id="syntaxSection" />

## 構文

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

<a id="parametersSection" />

### パラメーター

*pszDeployFilepath*<br />型: LPCWSTR

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

*pszTitleScratchRelativePath*<br />型: LPCWSTR

アプリ パッケージのデプロイ先の、タイトル スクラッチ ドライブのルート フォルダーからの相対パスへのポインターです。 Game Core のデプロイでは、この文脈でのタイトル スクラッチは、System OS と Game OS の両方からアクセスできる共有システム スクラッチ ドライブ (D:) を指します。

*fRemoveExtraFiles*<br />型: BOOL

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

*pCallback*<br />型: IXtfDeployCallback\*

デプロイ中に追跡可能なアクションが発生したときに呼び出す [IXtfDeployCallback](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t) コールバックへのポインターです。 デプロイ中にコールバックが不要な場合は `nullptr` を設定します。

*pfCanceled*<br />型: BOOL\*

デプロイがキャンセルされたかどうかを示すブール値を受け取るポインターです。

*pdwResult*<br />型: int\*

デプロイ操作の HRESULT を受け取るポインターです。 たとえば、開いているファイル ハンドルによってファイルの削除が妨げられている場合、このパラメーターは HRESULT エラー コードを受け取ります。

*pbstrPackageFullName*<br />型: LPBSTR

デプロイされたアプリ パッケージのバージョン番号、アーキテクチャ、カルチャを含む完全名を受け取るポインターです。

*pbstrAumidJson*<br />型: LPBSTR

アプリ パッケージに関連付けられた AUMID のリストの JSON 表現を受け取るポインターです。 リスト内のすべての AUMID は同じ `PackageFamilyName` を共有しますが、各 AUMID の感嘆符 (「!」) の後の AppIds が異なります。

<a id="retvalSection" />

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT エラー コードを返します。

<a id="remarksSection" />

## 解説

このメソッドは、テスト用に XBOX 開発キットにタイトルをプッシュ デプロイします。 タイトルは、`pszDeployFilepath` で指定されたフォルダーのタイトル スクラッチ ドライブにデプロイされます。 メソッドがデプロイを正常に完了した後、タイトルは起動する準備が整います。 アプリ パッケージのデプロイの詳細については、[XBOX 開発キットへのタイトルのデプロイ (NDA トピック)](/home/setup-install/concepts/deployment) を参照してください。

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

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

<a id="remarks_output" />

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

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

<a id="requirementsSection" />

## 要件

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

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

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

<a id="seealsoSection" />

## 関連項目

[IXtfApplicationClient](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)<br />[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Deploy](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::DeployEx](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)
- [IXtfApplicationClient::Uninstall](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Constrain](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Launch](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)