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

# Método CopyFiles

> Método IXtfBatchFileIOClient::CopyFiles

# Método IXtfBatchFileIOClient::CopyFiles

Copia em lote os arquivos enumerados em uma lista de cadeias de caracteres entre dois locais em um console de desenvolvimento e retorna informações sobre a operação.

> [!NOTE]
>
> Este método foi preterido. Em vez dele, use o método [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md).

## Sintaxe

```cpp theme={null}
public:
HRESULT CopyFiles(
         LPCWSTR pszRootDirectory,
         LPCWSTR *rgszRootDirectoryRelativeFiles,
         DWORD cRootDirectoryRelativeFiles,
         LPCWSTR pszDstDirectoryName,
         DWORD dwFlags,
         IXtfCopyFileCallback *pCallback
)  
```

### Parâmetros

*pszRootDirectory*\
Tipo: LPCWSTR

Um ponteiro para o diretório raiz da cópia em lote.

*rgszRootDirectoryRelativeFiles*\
Tipo: LPCWSTR\*

Um ponteiro para uma lista de cadeias de caracteres que contém os nomes dos arquivos a serem copiados.

*cRootDirectoryRelativeFiles*\
Tipo: DWORD

O número de arquivos da cópia em lote.

*pszDstDirectoryName*\
Tipo: LPCWSTR

Um ponteiro para o nome do diretório de destino da cópia em lote.

*dwFlags*\
Tipo: DWORD

Sinalizadores que especificam como copiar os arquivos. Esse parâmetro é uma combinação OR bit a bit das macros listadas na tabela a seguir.

| Valor | Macro | Descrição |
| - | - | - |
| 0x80000000 | XTFCOPYFILE\_DEFER | Adia a cópia do arquivo. |

*pCallback*\
Tipo: IXtfCopyFileCallback\*

Ponteiro para o retorno de chamada [IXtfCopyFileCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md) a ser chamado quando o status da cópia mudar.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

## Comentários

Essa função copia os arquivos enumerados em uma lista de cadeias de caracteres entre dois locais em um console de desenvolvimento como uma operação em lote e retorna informações sobre a operação.

> [!NOTE]
>
> Este método foi preterido. Em vez dele, use o método [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md).

## Requisitos

**Cabeçalho:** xtffileio.h

**Biblioteca:** xtffileio.lib

**Plataformas com suporte:** Windows (para ferramentas do console XBOX)

## Confira também

[IXtfFileIOClient::CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[Interface IXtfBatchFileIOClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/ixtfbatchfileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [Interface IXtfBatchFileIOClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/ixtfbatchfileioclient-xtffileio-xbox-microsoft-t.md)
- [CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [OnStartFileCopy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [OnFileCopyProgress](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [OnEndFileCopy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)