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

> Método IXtfCopyFileCallback::OnFileCopyProgress

# Método IXtfCopyFileCallback::OnFileCopyProgress

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

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

<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 pelo método [IXtfFileIOClient::CopyFiles](/pt-BR/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 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.

<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

- [IXtfCopyFileCallback::OnFileCopyProgress (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)