IXtfApplicationClient::Deploy
部署指定的应用包。
语法
public:
HRESULT Deploy(
LPCWSTR pszDeployFilepath,
BOOL fRemoveExtraFiles,
IXtfDeployCallback *pCallback,
BOOL *pfCanceled,
int *pdwResult,
LPBSTR pbstrPackageFullName,
LPBSTR pbstrAumidJson
)
参数
pszDeployFilepath
类型：LPCWSTR
要部署的内容的源路径。
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 开发工具包中进行测试。 你的游戏将被部署到游戏暂存驱动器中，在 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 主机工具）