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

在复制操作期间被调用以报告文件复制进度。

## 语法

```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
);
```

### 参数

`fileProgressCount _In_`\
类型：**size\_t**

自上次回调调用以来具有进度更新的文件数量。

`fileUpdates _In_reads_opt_(fileProgressCount)`\
类型：**const [WdCopyFileProgressInfo](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyfileprogressinfo.md)\***

指向 [WdCopyFileProgressInfo](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyfileprogressinfo.md) 结构体数组的指针，每个结构体包含单个文件的进度信息。如果 `fileProgressCount` 为 0，则可以为 `nullptr`。

`copyUpdates _In_`\
类型：**const [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md)\***

指向 [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md) 结构体的指针，该结构体包含整体复制操作进度的摘要。

`context _In_opt_`
类型：**void\***

在 [WdCopyStatusCallbacks](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopystatuscallbacks.md) 结构体中指定的用户自定义上下文指针。

### 返回值

类型：**HRESULT**

返回 `S_OK` 以继续复制操作。返回失败的 HRESULT 以中止复制。

## 备注

此回调由 [WdRemoteCopy](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdremotecopy.md) 调用，用于在复制操作期间报告单个文件的进度。调用频率由 [WdCopyStatusCallbacks](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopystatuscallbacks.md) 的 `refreshRateMs` 成员控制。

从该回调返回失败的 HRESULT 将中止复制操作，并从 `WdRemoteCopy` 返回该错误。

该回调在与 `WdRemoteCopy` 调用相同的线程上被调用。`fileUpdates` 数组、`copyUpdates` 结构体及其内容仅在回调调用期间有效。

## 要求

| 要求 | 值 |
| - | - |
| **头文件** | WdRemoteIteration.h |
| **库** | wdremoteapi.lib |
| **支持的操作系统** | Windows 11 及更高版本 |
| **支持的体系结构** | x64、ARM64 |

## 另请参阅

* [WdRemoteCopy](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFileProgressInfo](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyfileprogressinfo.md)
* [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md)
* [WdCopyStatusCallbacks](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopystatuscallbacks.md)
* [XBOX PC 远程迭代 API](https://docs.xbox.com/zh-CN/reference/remoting/remoteiteration_members.md)


## Related topics

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