> ## 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 IXtfCopyFileCallback::OnStartFileCopy

> Méthode IXtfCopyFileCallback::OnStartFileCopy

# Méthode IXtfCopyFileCallback::OnStartFileCopy

Appelée lorsque la copie d'un fichier entre deux emplacements sur une console de développement commence.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
public:
HRESULT OnStartFileCopy(
         LPCWSTR pszRootDirectory,
         LPCWSTR pszSearchPattern,
         LPCXTFFILEINFO pSrcFileInfo,
         LPCWSTR pszDstFileName
)  
```

<a id="parametersSection" />

### Paramètres

*pszRootDirectory*\
Type : LPCWSTR

Pointeur vers le chemin du répertoire racine de la copie.

*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é.

*pSrcFileInfo*\
Type : LPCXTFFILEINFO

Pointeur vers une structure [XTFFILEINFO](/fr-CA/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) qui contient des informations sur le fichier copié.

*pszDstFileName*\
Type : LPCWSTR

Pointeur vers le nom du fichier cible.

<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 fonction de rappel est appelée une seule fois par la méthode [IXtfFileIOClient::CopyFiles](/fr-CA/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) au début d'une opération de copie de fichiers. La taille de fichier retournée dans la structure [XTFFILEINFO](/fr-CA/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) représente la somme des tailles des fichiers à copier, en octets. Vous pouvez utiliser cette somme pour suivre la progression globale de l'opération de copie de fichiers. Si cette fonction de rappel retourne un code d'erreur HRESULT, l'opération de copie de fichiers est abandonnée.

<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 IXtfCopyFileCallback](/fr-CA/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/fr-CA/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfCopyFileCallback::OnStartFileCopy Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)