IXtfApplicationClient::DeployToTitleScratch
部署指定的应用包。语法
参数
pszDeployFilepath类型:LPCWSTR 要部署的内容的_源路径_。 pszTitleScratchRelativePath
类型:LPCWSTR 指向要部署应用包的路径的指针,该路径相对于 title scratch 驱动器的根文件夹。对于 Game Core 部署,此上下文中的 title scratch 指的是共享系统 scratch 驱动器,即 D:,System OS 和 Game OS 均可访问它。 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 主题)。
此函数以同步方式运行。
xbapp deploy 命令。有关 xbapp deploy 命令的详细信息,请参阅应用程序管理 (xbapp.exe) (NDA 主题)。
处理 LPBSTR 指针
有关处理此函数返回的 LPBSTR 指针的详细信息,请参阅为 BSTR 分配和释放内存。要求
头文件: xtfapplication.h 库: xtfapplication.lib 支持的平台: Windows(用于 XBOX 主机工具)另请参阅
IXtfApplicationClientXtfApplication
