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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### 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](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 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.

<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

Essa função é chamada uma vez pela função [IXtfFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m), 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](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t). 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.

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


## Related topics

- [Método IXtfCopyFileCallback::OnFileCopyProgress](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-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 IXtfFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [Método IXtfBatchFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)