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

# IXtfFileIOClient::CopyFiles (método)

> IXtfFileIOClient::CopyFiles (método)

# IXtfFileIOClient::CopyFiles (método)

Copia archivos entre dos ubicaciones de una consola de desarrollo y devuelve información sobre la operación.

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*pszSearchPattern*\
Tipo: LPCWSTR

Un puntero al patrón de búsqueda que define los nombres de archivo de los archivos de origen que se van a copiar. Este parámetro acepta caracteres comodín para hacer coincidir cadenas con el patrón indicado.

*dwIncludeAttributes*\
Tipo: DWORD

Una combinación OR bit a bit de los atributos de archivo que se incluirán en la copia. Consulte [Constantes de atributos de archivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obtener una lista de los atributos posibles.

*dwExcludeAttributes*\
Tipo: DWORD

Una combinación OR bit a bit de los atributos de archivo que se excluirán de la copia. Consulte [Constantes de atributos de archivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obtener una lista de los atributos posibles.

*dwRecursionLevels*\
Tipo: DWORD

El número de niveles de directorio en los que se aplicará la recursión para la copia, o -1 para abarcar todos los niveles del árbol de directorios.

*pszDstFileName*\
Tipo: LPCWSTR

Un puntero a los nombres de archivo de los archivos de destino en los que se copiará.

*dwFlags*\
Tipo: DWORD

Marcas que especifican cómo copiar los archivos. Se trata de una combinación OR bit a bit de las macros enumeradas en la tabla siguiente.

| Valor      | Macro              | Descripción                  |
| ---------- | ------------------ | ---------------------------- |
| 0x80000000 | XTFCOPYFILE\_DEFER | Aplaza la copia del archivo. |

*pCallback*\
Tipo: IXtfCopyFileCallback\*

Un puntero a la devolución de llamada [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) a la que se llamará cuando cambie el estado de la copia.

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se realiza correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

**IXtfFileIOClient::CopyFiles** inicia el proceso de copiar uno o varios archivos de una ubicación de la consola XBOX a otra. Para hacer un seguimiento del progreso del comando de copia de archivos, defina las funciones de devolución de llamada con una instancia de [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t). `IXtfCopyFileCallback` contiene funciones de devolución de llamada a las que se llama cuando la operación de copia de archivos comienza, cuando progresa y, finalmente, cuando termina.\
Al copiar varios archivos mediante el uso de caracteres comodín, se supone que el parámetro *pszDstFileName* es un directorio y todos los archivos copiados se colocan en ese directorio. Si el directorio no existe, se crea antes de copiar los archivos.

Los parámetros *dwIncludeAttributes* y *dwExcludeAttributes* actúan como filtros que indican qué archivos se copian. Estos parámetros no actúan como filtros que indican qué atributos de archivo se copian al copiar archivos.

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtffileio.h

**Biblioteca:** xtffileio.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

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


## Related topics

- [IXtfBatchFileIOClient::CopyFiles (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-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::OnFileCopyProgress (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::DeleteFiles (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)