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

# IXtfDeployCallback::OnDeployFileProgress

> IXtfDeployCallback::OnDeployFileProgress

# IXtfDeployCallback::OnDeployFileProgress

Rappel appelé pour signaler la progression du déploiement d'un fichier sur la console.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
public:
HRESULT OnDeployFileProgress(
         LPCWSTR pszFilePath,
         ULONGLONG ullBytesTransferred,
         ULONGLONG ullFileSize
)  
```

<a id="parametersSection" />

### Paramètres

*pszFilePath*\
Type : LPCWSTR

Chemin du fichier en cours de déploiement.

*ullBytesTransferred*\
Type : ULONGLONG

Nombre d'octets transférés jusqu'à présent.

*ullFileSize*\
Type : ULONGLONG

Taille totale du fichier en cours de transfert, en octets.

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` pour poursuivre le déploiement, ou un code d'erreur HRESULT pour annuler le déploiement.

<a id="remarksSection" />

## Remarques

Ce rappel est appelé lorsque le système de déploiement transfère des fichiers du PC qui effectue le déploiement vers la console. Ce rappel est appelé une fois pour chaque bloc de mémoire tampon transféré avec succès pour un fichier. Ce rappel est toujours appelé au moins deux fois pour chaque fichier transféré avec succès : une fois au début du déploiement et une fois à la fin du déploiement. Si un fichier de longueur nulle est déployé, les deux appels signalent que zéro octet sur zéro a été transféré. Pour plus d'informations sur la façon dont les fichiers sont évalués et sur le moment où les rappels sont appelés pendant le processus de déploiement, consultez [Interface IXtfDeployCallback](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t).

<Note>Le processus de transfert de fichiers pour le déploiement utilise plusieurs threads. Votre code doit corréler les messages de progression par `pszFilePath` et se protéger contre les problèmes de multithreading habituels.</Note>

Comme pour les autres rappels de `IXtfDeployCallback`, le processus de déploiement se poursuit si ce rappel retourne `S_OK`. Si ce rappel retourne un code d'erreur `HRESULT`, quel qu'il soit, le processus de déploiement est annulé immédiatement. Les fichiers déjà transférés ou supprimés restent en l'état, et les fichiers partiellement transférés sont fermés sous leur forme tronquée. Un autre déploiement doit être effectué pour garantir que tous les fichiers de la console sont complets et à jour.

## Configuration requise

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

**Bibliothèque :** xtfapplication.lib

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

## Voir aussi

[Interface IXtfDeployCallback](/fr/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/fr/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfDeployCallback::OnDeployFileProgress](/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployfileprogress-ixtfdeploycallback-xtfapplication-xbox-w.md)
- [IXtfDeployCallback::OnDeployChangeEvaluation](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeploychangeevaluation-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployInitialized Method](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployinitialized-ixtfdeploycallback-xtfapplication-xbox-wi.md)
- [IXtfDeployCallback::OnDeployExtraFileRemoved](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [IXtfDeployCallback::OnDeployExtraFileDetected](/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md)