Passer au contenu principal

​
IXtfApplicationClient::DeployEx

Déploie le package d’application spécifié.

​
Syntaxe

​
Paramètres

pszDeployFilepath
Type : LPCWSTR Le chemin d’accès source du contenu à déployer. deployTarget
Type : int Indique le lecteur sur lequel effectuer le déploiement. Les valeurs autorisées et leur signification sont les suivantes :
  • -1 indique l’appareil de déploiement par défaut spécifié par ‘xbconfig defaultstoragedevice’.
  • 0 signifie utiliser le lecteur commercial
  • 1 signifie utiliser le lecteur de développement sur les consoles qui en ont un
  • 2 indique le lecteur externe 1, 3 indique le lecteur externe 2, etc.
fRemoveExtraFiles
Type : BOOL Spécifiez TRUE pour supprimer les fichiers qui se trouvent déjà sur la console de développement, mais qui ne font pas partie du package de déploiement; sinon, FALSE pour les conserver. pCallback
Type : IXtfDeployCallback* Un pointeur vers le rappel IXtfDeployCallback à appeler lorsqu’une action pouvant être suivie se produit pendant le déploiement. Définissez-le sur nullptr si vous ne voulez pas de rappels pendant le déploiement. pfCanceled
Type : BOOL* Un pointeur qui reçoit une valeur booléenne indiquant si le déploiement a été annulé. pdwResult
Type : int* Un pointeur qui reçoit le HRESULT de l’opération de déploiement. Par exemple, si un handle de fichier ouvert empêche la suppression d’un fichier, ce paramètre reçoit le code d’erreur HRESULT. pbstrPackageFullName
Type : LPBSTR Un pointeur qui reçoit le nom complet du package d’application déployé, y compris le numéro de version, l’architecture et la culture. pbstrAumidJson
Type : LPBSTR Un pointeur qui reçoit une représentation JSON d’une liste des AUMID associés au package d’application. Tous les AUMID de la liste partagent le même PackageFamilyName, mais ont des AppId différents après le point d’exclamation (”!”) de chaque AUMID.

​
Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur HRESULT.

​
Remarques

Cette méthode effectue un déploiement par envoi (push) de votre titre sur un kit de développement XBOX à des fins de test. Votre titre est déployé sur le lecteur temporaire du titre, dans le dossier spécifié dans pszDeployFilepath. Une fois que la méthode a terminé le déploiement avec succès, votre titre est prêt à être lancé. Pour plus d’informations sur le déploiement de packages d’application, consultez Déploiement de votre titre sur votre kit de développement XBOX (rubrique sous NDA).
Cette fonction s’exécute de façon synchrone.
Cette méthode est semblable à la commande xbapp deploy de l’outil Gestion des applications (xbapp.exe), inclus dans XBOX Tools Framework (XTF). Pour plus d’informations sur la commande xbapp deploy, consultez Gestion des applications (xbapp.exe) (rubrique sous NDA).

​
Gestion des pointeurs LPBSTR

Pour plus d’informations sur la gestion des pointeurs LPBSTR retournés par cette fonction, consultez Allocation et libération de mémoire pour un BSTR.

​
Configuration requise

En-tête : xtfapplication.h Bibliothèque : xtfapplication.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

​
Voir aussi

IXtfApplicationClient
XtfApplication
Dernière modification le 6 octobre 2026

Sujets connexes

IXtfApplicationClient::DeployIXtfApplicationClient::DeployToTitleScratchIXtfApplicationClient::UninstallIXtfApplicationClient::ConstrainIXtfApplicationClient::Launch