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

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

## 语法

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

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

`copyUpdates _In_`\
类型：**const [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary)\***

指向 [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary) 结构体的指针，该结构体包含整体复制操作进度的摘要。

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

在 [WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks) 结构体中指定的用户自定义上下文指针。

### 返回值

类型：**HRESULT**

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

## 备注

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

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

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

## 要求

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

## 另请参阅

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCopyFileProgressInfo](/reference/remoting/structs/wdcopyfileprogressinfo)
* [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary)
* [WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks)
* [XBOX PC 远程迭代 API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyStatusCallbacks](/zh-CN/reference/remoting/structs/wdcopystatuscallbacks.md)
- [WdCopyFileProgressInfo](/zh-CN/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyOperationSummary](/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](/zh-CN/reference/remoting/remoteiteration_members.md)
- [WdCopyErrorCallback](/zh-CN/reference/remoting/callbacks/wdcopyerrorcallback.md)