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

# CopyFiles

> Méthode IXtfFileIOClient::CopyFiles

# Méthode IXtfFileIOClient::CopyFiles

Copie des fichiers entre deux emplacements sur une console de développement et retourne des informations sur l'opération.

## Syntaxe

```cpp theme={null}
public:
HRESULT CopyFiles(
         LPCWSTR pszSearchPattern,
         DWORD dwIncludeAttributes,
         DWORD dwExcludeAttributes,
         DWORD dwRecursionLevels,
         LPCWSTR pszDstFileName,
         DWORD dwFlags,
         IXtfCopyFileCallback *pCallback
)  
```

### Paramètres

*pszSearchPattern*\
Type : LPCWSTR

Pointeur vers le modèle de recherche qui définit les noms des fichiers sources à copier. Ce paramètre accepte les caractères génériques afin de faire correspondre les chaînes au modèle indiqué.

*dwIncludeAttributes*\
Type : DWORD

Combinaison OR au niveau du bit des attributs de fichier à inclure dans la copie. Consultez [Constantes d'attributs de fichier](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) pour obtenir la liste des attributs possibles.

*dwExcludeAttributes*\
Type : DWORD

Combinaison OR au niveau du bit des attributs de fichier à exclure de la copie. Consultez [Constantes d'attributs de fichier](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) pour obtenir la liste des attributs possibles.

*dwRecursionLevels*\
Type : DWORD

Nombre de niveaux de répertoire à parcourir de manière récursive pour la copie, ou -1 pour couvrir tous les niveaux de l'arborescence des répertoires.

*pszDstFileName*\
Type : LPCWSTR

Pointeur vers les noms des fichiers cibles vers lesquels copier.

*dwFlags*\
Type : DWORD

Indicateurs qui spécifient comment copier les fichiers. Il s'agit d'une combinaison OR au niveau du bit des macros répertoriées dans le tableau suivant.

| Valeur | Macro | Description |
| - | - | - |
| 0x80000000 | XTFCOPYFILE\_DEFER | Diffère la copie de fichiers. |

*pCallback*\
Type : IXtfCopyFileCallback\*

Pointeur vers le rappel [IXtfCopyFileCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md) à appeler lorsque l'état de la copie change.

### Valeur de retour

Type : HRESULT

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

## Remarques

**IXtfFileIOClient::CopyFiles** démarre le processus de copie d'un ou plusieurs fichiers d'un emplacement à un autre sur la console XBOX. Pour suivre la progression de la commande de copie de fichiers, définissez les fonctions de rappel avec une instance de [IXtfCopyFileCallback](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md). `IXtfCopyFileCallback` contient des fonctions de rappel qui sont appelées lorsque l'opération de copie de fichiers commence, lorsqu'elle progresse, et enfin lorsqu'elle est terminée.\
Lors de la copie de plusieurs fichiers à l'aide de caractères génériques, le paramètre *pszDstFileName* est considéré comme un répertoire et tous les fichiers copiés sont placés dans ce répertoire. Si le répertoire n'existe pas, il est créé avant la copie des fichiers.

Les paramètres *dwIncludeAttributes* et *dwExcludeAttributes* agissent comme des filtres qui indiquent quels fichiers sont copiés. Ces paramètres n'agissent pas comme des filtres indiquant quels attributs de fichier sont copiés lors de la copie des fichiers.

## Configuration requise

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

**Bibliothèque :** xtffileio.lib

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

## Voir aussi

[Interface IXtfFileIOClient](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [Méthode CopyFiles](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [Interface IXtfCopyFileCallback (contenu de l'interface)](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md)
- [OnEndFileCopy](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [OnStartFileCopy](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [OnFileCopyProgress](https://docs.xbox.com/fr/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)