> ## 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/ko/reference/remoting/functions/wdcreatecancellationhandle.md)을 호출하여 핸들을 생성합니다.
2. `cancellationHandle` 매개 변수를 통해 [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)에 핸들을 전달합니다.
3. 진행 중인 복사를 취소하려면 별도의 스레드에서 핸들과 함께 [WdCancelRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdcancelremotecopy.md)를 호출합니다.
4. `WdRemoteCopy`가 반환된 후 [WdCloseCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdclosecancellationhandle.md)을 호출하여 핸들을 닫습니다.

핸들은 [WdDuplicateCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdduplicatecancellationhandle.md)을 사용하여 복제할 수 있습니다. 각 핸들 복사본은 `WdCloseCancellationHandle`로 독립적으로 닫아야 합니다.

## 요구 사항

| 요구 사항 | 값 |
| - | - |
| **헤더** | WdRemoteIteration.h |
| **라이브러리** | wdremoteapi.lib |
| **지원 OS** | Windows 11 이상 |
| **지원 아키텍처** | x64, ARM64 |

## 함께 보기

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


## Related topics

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