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

# 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_`\
Type: **size\_t**

前回のコールバック呼び出し以降に進捗更新があったファイルの数。

`fileUpdates _In_reads_opt_(fileProgressCount)`\
Type: **const [WdCopyFileProgressInfo](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyfileprogressinfo.md)\***

各要素が個々のファイルの進捗情報を含む [WdCopyFileProgressInfo](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyfileprogressinfo.md) 構造体の配列へのポインター。`fileProgressCount` が 0 の場合、`nullptr` の場合があります。

`copyUpdates _In_`\
Type: **const [WdCopyOperationSummary](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyoperationsummary.md)\***

全体のコピー操作の進捗の要約を含む [WdCopyOperationSummary](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyoperationsummary.md) 構造体へのポインター。

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

[WdCopyStatusCallbacks](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopystatuscallbacks.md) 構造体で指定されたユーザー定義のコンテキスト ポインター。

### 戻り値

Type: **HRESULT**

コピー操作を継続するには `S_OK` を返します。コピーを中止するには失敗を示す HRESULT を返します。

## 解説

このコールバックは、[WdRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdremotecopy.md) により、コピー操作中に個々のファイルの進捗を報告するために呼び出されます。呼び出しの頻度は、[WdCopyStatusCallbacks](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopystatuscallbacks.md) の `refreshRateMs` メンバーによって制御されます。

このコールバックから失敗した HRESULT を返すと、コピー操作が中止され、そのエラーが `WdRemoteCopy` から返されます。

このコールバックは、`WdRemoteCopy` の呼び出しと同じスレッド上で呼び出されます。`fileUpdates` 配列、`copyUpdates` 構造体、およびそれらの内容は、コールバック呼び出しの間のみ有効です。

## 要件

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

## 関連項目

* [WdRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFileProgressInfo](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyfileprogressinfo.md)
* [WdCopyOperationSummary](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyoperationsummary.md)
* [WdCopyStatusCallbacks](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopystatuscallbacks.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/ja-jp/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdCopyStatusCallbacks](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopystatuscallbacks.md)
- [WdCopyFileProgressInfo](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyOperationSummary](https://docs.xbox.com/ja-jp/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/ja-jp/reference/remoting/remoteiteration_members.md)
- [WdDeleteErrorCallback](https://docs.xbox.com/ja-jp/reference/remoting/callbacks/wddeleteerrorcallback.md)