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

# WdCancellationHandle

> WdCancellationHandle

# WdCancellationHandle

進行中のコピー操作をキャンセルするために使用される不透明ハンドル。

## 構文

```cpp theme={null}
typedef struct WdCancellationHandleImpl* WdCancellationHandle;
```

## 解説

`WdCancellationHandle` は、不透明な内部構造体への typedef ポインターです。呼び出し元はハンドルのライフサイクルを管理する必要があります。

1. [WdCreateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcreatecancellationhandle.md) を呼び出してハンドルを作成します。
2. `cancellationHandle` パラメーターを介して [WdRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdremotecopy.md) にハンドルを渡します。
3. 進行中のコピーをキャンセルするには、別のスレッドからハンドルを指定して [WdCancelRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcancelremotecopy.md) を呼び出します。
4. `WdRemoteCopy` が戻った後、[WdCloseCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdclosecancellationhandle.md) を呼び出してハンドルを閉じます。

ハンドルは [WdDuplicateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdduplicatecancellationhandle.md) を使用して複製できます。ハンドルの各コピーは `WdCloseCancellationHandle` で個別に閉じる必要があります。

## 要件

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

## 関連項目

* [WdCreateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcreatecancellationhandle.md)
* [WdCloseCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdclosecancellationhandle.md)
* [WdDuplicateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdduplicatecancellationhandle.md)
* [WdRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdremotecopy.md)
* [WdCancelRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcancelremotecopy.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/ja-jp/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdDuplicateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [WdCloseCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdclosecancellationhandle.md)
- [WdCreateCancellationHandle](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcreatecancellationhandle.md)
- [WdCancelRemoteCopy](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcancelremotecopy.md)
- [WdCancelRemoteDelete](https://docs.xbox.com/ja-jp/reference/remoting/functions/wdcancelremotedelete.md)