> ## 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`\
Type: **[WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)**

ファイル コピーの進捗を報告するために呼び出されるコールバック関数。ファイルの進捗更新が不要な場合は `nullptr` に設定します。

`refreshRateMs`\
Type: **uint32\_t**

`copyFilesStatusCallback` のコールバック呼び出し間の最小間隔 (ミリ秒単位)。指定しない、または `0` に設定した場合、既定の更新レートは 500 ミリ秒です。

`copyErrorCallback`\
Type: **[WdCopyErrorCallback](/reference/remoting/callbacks/wdcopyerrorcallback)**

コピー操作からエラーや警告などの診断メッセージを受け取るオプションのコールバック関数。診断メッセージが不要な場合は `nullptr` に設定します。

`context`\
Type: **void\***

両方のコールバック関数に渡される、オプションのユーザー定義のコンテキスト ポインター。コンテキストが不要な場合は `nullptr` に設定します。

## 解説

コピー操作中に進捗更新と診断メッセージを受け取るには、`statusCallbacks` パラメーターを介してこの構造体を [WdRemoteCopy](/reference/remoting/functions/wdremotecopy) に渡します。`refreshRateMs` メンバーは、`copyFilesStatusCallback` が呼び出される頻度を制御します。指定しない、または `0` に設定した場合、既定の更新レートは 500 ミリ秒です。`context` ポインターは変更されずに両方のコールバックに渡されるため、コールバックをアプリケーション固有の状態に関連付けることができます。

## 要件

| 要件                   | 値                   |
| -------------------- | ------------------- |
| **ヘッダー**             | WdRemoteIteration.h |
| **ライブラリ**            | wdremoteapi.lib     |
| **サポートされている OS**     | Windows 11 以降       |
| **サポートされているアーキテクチャ** | x64、ARM64           |

## 関連項目

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)
* [WdCopyErrorCallback](/reference/remoting/callbacks/wdcopyerrorcallback)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)