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

# OnStartFileCopy

> Método IXtfCopyFileCallback::OnStartFileCopy

# Método IXtfCopyFileCallback::OnStartFileCopy

Chamado quando um arquivo começa a ser copiado entre dois locais em um console de desenvolvimento.

## Sintaxe

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

### Parâmetros

*pszRootDirectory*\
Tipo: LPCWSTR

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

*pszSearchPattern*\
Tipo: LPCWSTR

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

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

Ponteiro para o nome do arquivo de destino.

### 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 de retorno de chamada é chamada uma vez pelo método [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) no início de uma operação de cópia de arquivo. O tamanho do arquivo retornado na estrutura [XTFFILEINFO](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md) representa a soma dos tamanhos dos arquivos que precisam ser copiados, em bytes. Você pode usar essa soma para acompanhar o progresso geral da operação de cópia de arquivo. Se essa função de retorno de chamada retornar um código de erro HRESULT, a operação de cópia de arquivo será anulada.

## 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)
- [OnEndFileCopy](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)