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

# Méthode IXtfFileIOClient::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.

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### 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 pour faire correspondre les chaînes au modèle indiqué.

*dwIncludeAttributes*\
Type : DWORD

Combinaison OR au niveau du bit d'attributs de fichier à inclure pour 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 d'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 façon récursive pour la copie, ou -1 pour couvrir tous les niveaux de l'arborescence de 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](/fr-CA/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) à appeler lorsque l'état de la copie change.

<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

**IXtfFileIOClient::CopyFiles** lance le processus de copie d'un ou de 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](/fr-CA/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t). `IXtfCopyFileCallback` contient des fonctions de rappel qui sont appelées au début de l'opération de copie de fichiers, pendant sa progression et enfin une fois qu'elle est terminée.\
Lors de la copie de plusieurs fichiers au moyen 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 les fichiers à copier. Ces paramètres n'agissent pas comme des filtres qui indiquent les attributs de fichier à copier lors de la copie des fichiers.

<a id="requirementsSection" />

## Configuration requise

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

**Bibliothèque :** xtffileio.lib

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

<a id="seealsoSection" />

## Voir aussi

[Interface IXtfFileIOClient](/fr-CA/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/fr-CA/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfFileIOClient::CopyFiles Method](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles メソッド](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient::CopyFiles Method](/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)