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

# 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](/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo)\***

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

`copyUpdates _In_`\
Tipo: **const [WdCopyOperationSummary](/pt-BR/reference/remoting/structs/wdcopyoperationsummary)\***

Um ponteiro para uma estrutura [WdCopyOperationSummary](/pt-BR/reference/remoting/structs/wdcopyoperationsummary) 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](/pt-BR/reference/remoting/structs/wdcopystatuscallbacks).

### 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](/pt-BR/reference/remoting/functions/wdremotecopy).

## Comentários

Este retorno de chamada é invocado por [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy) 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](/pt-BR/reference/remoting/structs/wdcopystatuscallbacks).

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](/pt-BR/reference/remoting/functions/wdremotecopy)
* [WdCopyFileProgressInfo](/pt-BR/reference/remoting/structs/wdcopyfileprogressinfo)
* [WdCopyOperationSummary](/pt-BR/reference/remoting/structs/wdcopyoperationsummary)
* [WdCopyStatusCallbacks](/pt-BR/reference/remoting/structs/wdcopystatuscallbacks)
* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyFilesStatusCallback](/ko/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks.md)