> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DeployEx

> IXtfApplicationClient::DeployEx

# IXtfApplicationClient::DeployEx

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

## Syntaxe

```cpp theme={null}
public:
HRESULT DeployEx(
         LPCWSTR pszDeployFilepath,
         int deployTarget,
         BOOL fRemoveExtraFiles,
         IXtfDeployCallback *pCallback,
         BOOL *pfCanceled,
         int *pdwResult,
         LPBSTR pbstrPackageFullName,
         LPBSTR pbstrAumidJson
)  
```

### 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 le périphérique de déploiement par défaut spécifié par 'xbconfig defaultstoragedevice'.
* 0 signifie utiliser le lecteur de vente au détail
* 1 signifie utiliser le lecteur de développement sur les consoles qui en possèdent un
* 2 indique le lecteur externe 1, 3 indique le lecteur externe 2, etc.

*fRemoveExtraFiles*\
Type : BOOL

Spécifiez TRUE pour supprimer les fichiers déjà présents sur la console de développement qui ne font pas partie du package de déploiement ; sinon, FALSE pour les conserver.

*pCallback*\
Type : IXtfDeployCallback\*

Pointeur vers le rappel [IXtfDeployCallback](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t) à appeler lorsqu'une action pouvant être suivie se produit pendant le déploiement. Définissez la valeur `nullptr` si vous ne souhaitez pas de rappels pendant le déploiement.

*pfCanceled*\
Type : BOOL\*

Pointeur qui reçoit une valeur booléenne indiquant si le déploiement a été annulé.

*pdwResult*\
Type : int\*

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

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

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 transmission de votre titre sur un kit de développement XBOX à des fins de test. Votre titre est déployé sur le lecteur de travail 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)](/fr/home/setup-install/concepts/deployment.md).

> [!NOTE]
>
> Cette fonction s'exécute de façon synchrone.

Cette méthode est similaire à 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)](/fr/tools/tools-console/commandlinetools/xbapp.md).

### 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](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019).

## 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](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/fr/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [Deploy](/fr/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [XINPUT_VIBRATION_EX](/fr/reference/input/xinputongameinput/structs/xinput_vibration_ex.md)
- [GAMEPAD_REPORT_EX](/fr/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [ListUsersEx](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)
- [SendGamepadReportEx](/fr/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/ixtfinputclient_sendgamepadreportex.md)