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

# OnFileCopyProgress

> Método IXtfCopyFileCallback::OnFileCopyProgress

# Método IXtfCopyFileCallback::OnFileCopyProgress

Chamado quando o progresso de uma cópia de arquivo muda.

## Sintaxe

```cpp theme={null}
public:
HRESULT OnFileCopyProgress(
         LPCWSTR pszSrcFileName,
         LPCWSTR pszDstFileName,
         ULONGLONG ullFileSize,
         ULONGLONG ullBytesCopied
)  
```

### Parâmetros

*pszSrcFileName*\
Tipo: LPCWSTR

Um ponteiro para o nome do arquivo de origem. Esse parâmetro foi preterido e o valor agora é uma cópia de pszDstFileName.

*pszDstFileName*\
Tipo: LPCWSTR

Um ponteiro para o nome do arquivo de destino.

*ullFileSize*\
Tipo: ULONGLONG

O tamanho total do arquivo de origem, em bytes.

*ullBytesCopied*\
Tipo: ULONGLONG

O número de bytes do arquivo que foram copiados até o momento.

### 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 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) para cada pacote transferido durante a operação de cópia de arquivo. A chamada inicial para **IXtfCopyFileCallback::OnFileCopyProgress** de um arquivo especifica 0 bytes em `ullBytesCopied` e MAX\_FILE\_SIZE bytes em `ullFileSize`. Essa chamada inicial indica que você começou a copiar um novo arquivo. Em seguida, você pode usar as informações de arquivo especificadas nas chamadas subsequentes de **IXtfCopyFileCallback::OnFileCopyProgress** para acompanhar e exibir o progresso durante a 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)
- [WdCopyFileProgressInfo](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyFilesStatusCallback](https://docs.xbox.com/pt-BR/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyOperationSummary](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyoperationsummary.md)
- [CopyFiles](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)