> ## 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::DeployToTitleScratch

> IXtfApplicationClient::DeployToTitleScratch

# IXtfApplicationClient::DeployToTitleScratch

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

<a id="syntaxSection" />

## Syntaxe

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

*pszTitleScratchRelativePath*<br />Type : LPCWSTR

Pointeur vers le chemin d'accès, relatif au dossier racine du lecteur de travail du titre, dans lequel déployer le package d'application. Pour les déploiements Game Core, le lecteur de travail du titre désigne dans ce contexte le lecteur de travail système partagé, ou D:, accessible à la fois par le System OS et le Game OS.

*fRemoveExtraFiles*<br />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*<br />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*<br />Type : BOOL\*

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

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

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

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

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

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


## Related topics

- [IXtfApplicationClient::DeployToTitleScratch](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deploytotitlescratch.md)
- [IXtfApplicationClient::Deploy](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::DeployEx](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/ixtfapplicationclient-deployex.md)