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

# WdCopyFilesStatusCallback

> WdCopyFilesStatusCallback

# WdCopyFilesStatusCallback

Chamado para relatar o progresso da cópia de arquivos durante uma operação de cópia.

## Sintaxe

```cpp theme={null}
typedef HRESULT (*WdCopyFilesStatusCallback)(
    _In_ size_t fileProgressCount,
    _In_reads_opt_(fileProgressCount) const WdCopyFileProgressInfo* fileUpdates,
    _In_ const WdCopyOperationSummary* copyUpdates,
    _In_opt_ void* context
);
```

### Parâmetros

`fileProgressCount _In_`\
Tipo: **size\_t**

O número de arquivos que têm atualizações de progresso desde a última invocação do retorno de chamada.

`fileUpdates _In_reads_opt_(fileProgressCount)`\
Tipo: **const [WdCopyFileProgressInfo](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo.md)\***

Um ponteiro para uma matriz de estruturas [WdCopyFileProgressInfo](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo.md), cada uma contendo informações de progresso de um arquivo individual. Pode ser `nullptr` se `fileProgressCount` for 0.

`copyUpdates _In_`\
Tipo: **const [WdCopyOperationSummary](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyoperationsummary.md)\***

Um ponteiro para uma estrutura [WdCopyOperationSummary](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyoperationsummary.md) que contém um resumo do progresso geral da operação de cópia.

`context _In_opt_`
Tipo: **void\***

O ponteiro de contexto definido pelo usuário que foi especificado na estrutura [WdCopyStatusCallbacks](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopystatuscallbacks.md).

### Valor retornado

Tipo: **HRESULT**

Um HRESULT de falha do retorno de chamada é registrado em log, mas não anula a cópia nem altera o resultado retornado por [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md).

## Comentários

Este retorno de chamada é invocado por [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md) para relatar o progresso de arquivos individuais durante uma operação de cópia. A frequência das invocações é controlada pelo membro `refreshRateMs` de [WdCopyStatusCallbacks](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopystatuscallbacks.md).

O retorno de chamada é invocado no mesmo thread da chamada `WdRemoteCopy`. A matriz `fileUpdates`, a estrutura `copyUpdates` e o conteúdo delas só são válidos durante a invocação do retorno de chamada.

## Requisitos

| Requisito | Valor |
| - | - |
| **Cabeçalho** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **SO com suporte** | Windows 11 e posterior |
| **Arquiteturas com suporte** | x64, ARM64 |

## Confira também

* [WdRemoteCopy](https://docs.xbox.com/pt-BR/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFileProgressInfo](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo.md)
* [WdCopyOperationSummary](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyoperationsummary.md)
* [WdCopyStatusCallbacks](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopystatuscallbacks.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/pt-BR/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdCopyStatusCallbacks](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopystatuscallbacks.md)
- [WdCopyFileProgressInfo](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyOperationSummary](https://docs.xbox.com/pt-BR/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/pt-BR/reference/remoting/remoteiteration_members.md)
- [WdDeleteErrorCallback](https://docs.xbox.com/pt-BR/reference/remoting/callbacks/wddeleteerrorcallback.md)