> ## 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.

# IXtfApplicationClient::DeployEx

> IXtfApplicationClient::DeployEx

# IXtfApplicationClient::DeployEx

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### Paramètres

*pszDeployFilepath*<br />Type : LPCWSTR

Le *chemin d'accès source* du contenu à déployer.

*deployTarget*<br />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*<br />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*<br />Type : IXtfDeployCallback\*

Un pointeur vers le rappel [IXtfDeployCallback](/fr-CA/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-le sur `nullptr` si vous ne voulez pas de rappels pendant le déploiement.

*pfCanceled*<br />Type : BOOL\*

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

*pdwResult*<br />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*<br />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*<br />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.

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

<a id="remarksSection" />

## 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)](/fr-CA/home/setup-install/concepts/deployment).

<Note>
  Cette fonction s'exécute de façon synchrone.
</Note>

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)](/fr-CA/tools/tools-console/commandlinetools/xbapp).

<a id="remarks_output" />

### 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).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfapplication.h

**Bibliothèque :** xtfapplication.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[IXtfApplicationClient](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)<br />[XtfApplication](/fr-CA/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Deploy](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::DeployToTitleScratch](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deploytotitlescratch.md)
- [IXtfApplicationClient::Uninstall](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Constrain](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Suspend](/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/suspend-ixtfapplicationclient-xtfapplication-xbox-windows.md)