> ## 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::Deploy

> IXtfApplicationClient::Deploy

# IXtfApplicationClient::Deploy

部署指定的应用包。

<a id="syntaxSection" />

## 语法

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

<a id="parametersSection" />

### 参数

*pszDeployFilepath*<br />类型：LPCWSTR

要部署的内容的源路径。

*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 中感叹号（"!"）之后的 AppId 不同。

<a id="retvalSection" />

### 返回值

类型：HRESULT

如果成功则返回 `S_OK`；否则返回 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

此方法将你的标题推送部署到 XBOX 开发套件上以进行测试。你的标题被部署到 title scratch 驱动器上 `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

- [IXtfDeployCallback::OnDeployExtraFileRemoved](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfApplicationClient::DeployEx](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)
- [IXtfApplicationClient::DeployToTitleScratch](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deploytotitlescratch.md)
- [IXtfApplicationClient::Uninstall](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Constrain](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)