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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### 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](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) que contém informações sobre o arquivo copiado.

*pszDstFileName*\
Tipo: LPCWSTR

Ponteiro para o nome do arquivo de destino.

<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 de retorno de chamada é chamada uma vez pelo método [IXtfFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) no início de uma operação de cópia de arquivo. O tamanho do arquivo retornado na estrutura [XTFFILEINFO](/pt-BR/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t) 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.

<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::OnEndFileCopy](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-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 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)