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

# WdCancellationHandle

> WdCancellationHandle

# WdCancellationHandle

진행 중인 복사 작업을 취소하는 데 사용되는 불투명 핸들입니다.

## 구문

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

## 설명

`WdCancellationHandle`은 불투명한 내부 구조체에 대한 typedef 포인터입니다. 호출자는 핸들 수명 주기를 관리할 책임이 있습니다:

1. [WdCreateCancellationHandle](/reference/remoting/functions/wdcreatecancellationhandle)을 호출하여 핸들을 생성합니다.
2. `cancellationHandle` 매개 변수를 통해 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)에 핸들을 전달합니다.
3. 진행 중인 복사를 취소하려면 별도의 스레드에서 핸들과 함께 [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy)를 호출합니다.
4. `WdRemoteCopy`가 반환된 후 [WdCloseCancellationHandle](/reference/remoting/functions/wdclosecancellationhandle)을 호출하여 핸들을 닫습니다.

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

## 요구 사항

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

## 함께 보기

* [WdCreateCancellationHandle](/reference/remoting/functions/wdcreatecancellationhandle)
* [WdCloseCancellationHandle](/reference/remoting/functions/wdclosecancellationhandle)
* [WdDuplicateCancellationHandle](/reference/remoting/functions/wdduplicatecancellationhandle)
* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdDuplicateCancellationHandle](/ko/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [WdCloseCancellationHandle](/ko/reference/remoting/functions/wdclosecancellationhandle.md)
- [WdCreateCancellationHandle](/ko/reference/remoting/functions/wdcreatecancellationhandle.md)
- [WdCancelRemoteCopy](/ko/reference/remoting/functions/wdcancelremotecopy.md)
- [WdRemoteCopy](/ko/reference/remoting/functions/wdremotecopy.md)