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

# WdCopyStatusCallbacks

> WdCopyStatusCallbacks

# WdCopyStatusCallbacks

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

## 语法

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

### 成员

`copyFilesStatusCallback`\
类型：**[WdCopyFilesStatusCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)**

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

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

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

`copyErrorCallback`\
类型：**[WdCopyErrorCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyerrorcallback.md)**

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

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

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

## 备注

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

## 要求

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

## 另请参阅

* [WdRemoteCopy](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFilesStatusCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
* [WdCopyErrorCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyerrorcallback.md)
* [XBOX PC 远程迭代 API](https://docs.xbox.com/zh-CN/reference/remoting/remoteiteration_members.md)


## Related topics

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