> ## 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](/zh-TW/reference/remoting/callbacks/wdcopyfilesstatuscallback)**

用來回報檔案複製進度的回呼函式。如果不需要檔案進度更新，請設為 `nullptr`。

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

`copyFilesStatusCallback` 每次叫用之間所需的間隔 (以毫秒為單位)。如果未指定或設為 `0`，預設的重新整理頻率為 500 毫秒。

`copyErrorCallback`\
類型：**[WdCopyErrorCallback](/zh-TW/reference/remoting/callbacks/wdcopyerrorcallback)**

選用的回呼函式，用於接收複製作業的診斷訊息，例如錯誤或警告。如果不需要診斷訊息，請設為 `nullptr`。

`context`\
類型：**void\***

選用的使用者定義內容指標，會傳遞給兩個回呼函式。如果不需要內容，請設為 `nullptr`。

## 備註

透過 `statusCallbacks` 參數將此結構傳遞給 [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy)，以便在複製作業期間接收進度更新與診斷訊息。`refreshRateMs` 成員控制叫用 `copyFilesStatusCallback` 的頻率。如果未指定或設為 `0`，預設的重新整理頻率為 500 毫秒。`context` 指標會原封不動地傳遞給兩個回呼，讓您可以將回呼與應用程式特定的狀態建立關聯。

## 需求

| 需求 | 值 |
| - | - |
| **標頭** | WdRemoteIteration.h |
| **程式庫** | wdremoteapi.lib |
| **支援的作業系統** | Windows 11 及更新版本 |
| **支援的架構** | x64、ARM64 |

## 另請參閱

* [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy)
* [WdCopyFilesStatusCallback](/zh-TW/reference/remoting/callbacks/wdcopyfilesstatuscallback)
* [WdCopyErrorCallback](/zh-TW/reference/remoting/callbacks/wdcopyerrorcallback)
* [XBOX PC 遠端反覆運算 API](/zh-TW/reference/remoting/remoteiteration_members)


## Related topics

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