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

# OnEndFileCopy

> Método IXtfCopyFileCallback::OnEndFileCopy

# Método IXtfCopyFileCallback::OnEndFileCopy

Chamado quando um arquivo termina de ser copiado entre dois locais em um console de desenvolvimento.

## Sintaxe

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

### Parâmetros

*pszRootDirectory*\
Tipo: LPCWSTR

Um ponteiro para o caminho do diretório raiz da cópia.

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

*pSrcFileInfo*\
Tipo: LPCXTFFILEINFO

Um ponteiro para uma estrutura [XTFFILEINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) que contém informações sobre o arquivo copiado.

*pszDstFileName*\
Tipo: LPCWSTR

Um ponteiro para o nome do arquivo de destino.

*hrErrorCode*\
Tipo: HRESULT

Um código de êxito ou de erro HRESULT.

### 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 é chamada uma vez pela função [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md), ao final de uma operação de cópia de arquivo. As informações especificadas na função de retorno de chamada incluem o número total de bytes transferidos na estrutura [XTFFILEINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md). Você pode verificar o parâmetro `hrErrorCode` dessa função para identificar quaisquer erros que possam ter ocorrido durante a operação de cópia de arquivo.

## Requisitos

**Cabeçalho:** xtffileio.h

**Biblioteca:** xtffileio.lib

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

## Confira também

[Interface IXtfCopyFileCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [Interface IXtfCopyFileCallback (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md)
- [XTFFILEINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-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)
- [Método CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-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)