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

# WdCopyStatusCallbacks

> WdCopyStatusCallbacks

# WdCopyStatusCallbacks

包含用于接收复制状态更新的回调函数指针和设置。

## 语法

```cpp theme={null}
struct WdCopyStatusCallbacks
{
    WdCopyFilesStatusCallback copyFilesStatusCallback;
    uint32_t refreshRateMs;
    WdCopyErrorCallback copyErrorCallback;
    void* context;
};
```

### 成员

`copyFilesStatusCallback`\
类型：**[WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)**

用于报告文件复制进度的回调函数。如果不需要文件进度更新，请设置为 `nullptr`。

`refreshRateMs`\
类型：**uint32\_t**

`copyFilesStatusCallback` 回调调用之间的最小间隔（以毫秒为单位）。如果未指定或设置为 `0`，则默认刷新率为 500 毫秒。

`copyErrorCallback`\
类型：**[WdCopyErrorCallback](/reference/remoting/callbacks/wdcopyerrorcallback)**

一个可选的回调函数，用于接收来自复制操作的诊断消息（例如错误或警告）。如果不需要诊断消息，请设置为 `nullptr`。

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

一个可选的用户自定义上下文指针，将传递给两个回调函数。如果不需要上下文，请设置为 `nullptr`。

## 备注

通过 `statusCallbacks` 参数将此结构体传递给 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)，以在复制操作期间接收进度更新和诊断消息。`refreshRateMs` 成员控制 `copyFilesStatusCallback` 的调用频率。如果未指定或设置为 `0`，则默认刷新率为 500 毫秒。`context` 指针会原样传递给两个回调，从而允许你将回调与应用程序特定的状态相关联。

## 要求

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

## 另请参阅

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)
* [WdCopyErrorCallback](/reference/remoting/callbacks/wdcopyerrorcallback)
* [XBOX PC 远程迭代 API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyFilesStatusCallback](/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyErrorCallback](/zh-CN/reference/remoting/callbacks/wdcopyerrorcallback.md)
- [WdCopyErrorSeverity](/zh-CN/reference/remoting/enums/wdcopyerrorseverity.md)
- [WdRemoteCopy](/zh-CN/reference/remoting/functions/wdremotecopy.md)
- [XBOX PC Remote Iteration API](/zh-CN/reference/remoting/remoteiteration_members.md)