IXtfApplicationClient::DeployEx
Deploys the specified app package.
Syntax
public:
HRESULT DeployEx(
LPCWSTR pszDeployFilepath,
int deployTarget,
BOOL fRemoveExtraFiles,
IXtfDeployCallback *pCallback,
BOOL *pfCanceled,
int *pdwResult,
LPBSTR pbstrPackageFullName,
LPBSTR pbstrAumidJson
)
Parameters
pszDeployFilepath
Type: LPCWSTR
The source path for the content that is going to be deployed.
deployTarget
Type: int
Indicates the drive to deploy to. Allowed values and their meanings are as follows:
- -1 indicates the default deployment device specified by 'xbconfig defaultstoragedevice'.
- 0 means use the retail drive
- 1 means use the development drive on consoles that have one
- 2 indicates external drive 1, 3 indicates external drive 2, etc
fRemoveExtraFiles
Type: BOOL
Specify TRUE to remove files that are already on the development console but are not part of the deployment package; otherwise, FALSE to keep them.
pCallback
Type: IXtfDeployCallback*
A pointer to the IXtfDeployCallback callback to invoke when a trackable action occurs during the deployment. Set to nullptr if you do not want callbacks during deployment.
pfCanceled
Type: BOOL*
A pointer that receives a Boolean value that indicates whether deployment was canceled.
pdwResult
Type: int*
A pointer that receives the HRESULT of the deployment operation. For example, if an open file handle prevents a file from being deleted, this parameter receives the HRESULT error code.
pbstrPackageFullName
Type: LPBSTR
A pointer that receives the full name of the deployed app package, including the version number, architecture, and culture.
pbstrAumidJson
Type: LPBSTR
A pointer that receives a JSON representation of a list of the AUMIDs associated with the app package. All AUMIDs in the list share the same PackageFamilyName, but have different AppIds after the exclamation mark ("!") in each AUMID.
Return value
Type: HRESULT
Returns S_OK if successful; otherwise, returns an HRESULT error code.
Remarks
This method performs a push deployment of your title onto an Xbox dev kit for testing. Your title is deployed to the title scratch drive, in the folder specified in pszDeployFilepath. After the method successfully completes the deployment, your title is ready to launch. For more information about deploying app packages, see Deploying your title to your Xbox Development Kit (NDA topic)Requiere autorización.
Note
This function runs synchronously.
This method is similar to the xbapp deploy command from the Application Management (xbapp.exe) tool, included as part of the Xbox Tools Framework (XTF). For more information about the xbapp deploy command, see Application Management (xbapp.exe) (NDA topic)Requiere autorización.
Handling LPBSTR pointers
For more information about handling LPBSTR pointers returned by this function, see Allocating and Releasing Memory for a BSTR.
Requirements
Header: xtfapplication.h
Library: xtfapplication.lib
Supported platforms: Windows (for Xbox console tools)