Skip to main content

IXtfApplicationClient::DeployEx

部署指定的应用包。

语法

参数

pszDeployFilepath
类型:LPCWSTR
要部署的内容的_源路径_。 deployTarget
类型:int
指示要部署到的驱动器。允许的值及其含义如下:
  • -1 表示由 ‘xbconfig defaultstoragedevice’ 指定的默认部署设备。
  • 0 表示使用零售驱动器
  • 1 表示在具有开发驱动器的主机上使用开发驱动器
  • 2 表示外部驱动器 1、3 表示外部驱动器 2,依此类推
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 开发套件上以进行测试。你的标题被部署到 title scratch 驱动器上 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
最后修改于 2026年8月24日