Passer au contenu principal

​
IXtfApplicationClient::DeployToTitleScratch

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

​
Syntaxe

​
Paramètres

pszDeployFilepath
Type : LPCWSTR Le chemin d’accès source du contenu à déployer. pszTitleScratchRelativePath
Type : LPCWSTR Un pointeur vers le chemin d’accès, relatif au dossier racine du lecteur temporaire du titre, dans lequel déployer le package d’application. Pour les déploiements Game Core, le lecteur temporaire du titre désigne dans ce contexte le lecteur temporaire système partagé, ou D:, qui est accessible à la fois par le System OS et le Game OS. 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