> ## 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étodo IXtfFileIOClient::CopyFiles

> Método IXtfFileIOClient::CopyFiles

# Método IXtfFileIOClient::CopyFiles

Copia arquivos entre dois locais em um console de desenvolvimento e retorna informações sobre a operação.

<a id="syntaxSection" />

## Sintaxe

```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

Um ponteiro para o padrão de pesquisa que define os nomes dos arquivos de origem a serem copiados. Esse parâmetro aceita caracteres curinga para corresponder a cadeias de caracteres com o padrão indicado.

*dwIncludeAttributes*\
Tipo: DWORD

Uma combinação OR bit a bit de atributos de arquivo a serem incluídos na cópia. Consulte [Constantes de atributo de arquivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obter uma lista dos atributos possíveis.

*dwExcludeAttributes*\
Tipo: DWORD

Uma combinação OR bit a bit de atributos de arquivo a serem excluídos da cópia. Consulte [Constantes de atributo de arquivo](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) para obter uma lista dos atributos possíveis.

*dwRecursionLevels*\
Tipo: DWORD

O número de níveis de diretório a serem percorridos recursivamente na cópia, ou -1 para abranger todos os níveis da árvore de diretórios.

*pszDstFileName*\
Tipo: LPCWSTR

Um ponteiro para os nomes dos arquivos de destino para os quais copiar.

*dwFlags*\
Tipo: DWORD

Sinalizadores que especificam como copiar os arquivos. É 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\*

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

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

**IXtfFileIOClient::CopyFiles** inicia o processo de cópia de um ou mais arquivos de um local para outro no console XBOX. Para acompanhar o progresso do comando de cópia de arquivo, defina as funções de retorno de chamada com uma instância de [IXtfCopyFileCallback](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t). `IXtfCopyFileCallback` contém funções de retorno de chamada que são chamadas quando a operação de cópia de arquivo começa, quando progride e, por fim, depois de terminar.\
Ao copiar vários arquivos usando caracteres curinga, presume-se que o parâmetro *pszDstFileName* seja um diretório, e todos os arquivos copiados são colocados nesse diretório. Se o diretório não existir, ele será criado antes da cópia dos arquivos.

Os parâmetros *dwIncludeAttributes* e *dwExcludeAttributes* atuam como filtros que indicam quais arquivos são copiados. Esses parâmetros não atuam como filtros que indicam quais atributos de arquivo são copiados ao copiar arquivos.

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtffileio.h

**Biblioteca:** xtffileio.lib

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

<a id="seealsoSection" />

## Confira também

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


## Related topics

- [Método IXtfBatchFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnStartFileCopy](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnFileCopyProgress](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfCopyFileCallback::OnEndFileCopy](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [Método IXtfFileIOClient::DeleteFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)