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

# Deploy

> IXtfApplicationClient::Deploy

# IXtfApplicationClient::Deploy

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

## Syntaxe

```cpp theme={null}
public:
HRESULT Deploy(
         LPCWSTR pszDeployFilepath,
         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.

*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](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md) à 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)](https://docs.xbox.com/fr-CA/home/setup-install/concepts/deployment.md).

> [!NOTE]
>
> 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)](https://docs.xbox.com/fr-CA/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](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [DeployEx](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)
- [OnDeployError](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployerror-ixtfdeploycallback-xtfapplication-xbox-windows.md)
- [OnDeployInitialized](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [OnDeployMetrics](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploymetrics-ixtfdeploycallback-xtfapplication-xbox-window.md)
- [DeployToTitleScratch](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deploytotitlescratch.md)