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

# WdCreateCancellationHandle

> WdCreateCancellationHandle

# WdCreateCancellationHandle

[WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)로 시작된 복사 작업을 취소하는 데 사용할 수 있는 취소 핸들을 생성합니다.

## 구문

```cpp theme={null}
HRESULT WdCreateCancellationHandle(  
         _Out_ WdCancellationHandle* cancellationHandle  
);  
```

### 매개 변수

`_Out_ cancellationHandle`\
형식: **[WdCancellationHandle](https://docs.xbox.com/ko/reference/remoting/structs/wdcancellationhandle.md)\***

새로 생성된 취소 핸들을 받습니다. 호출자는 더 이상 필요하지 않을 때 [WdCloseCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdclosecancellationhandle.md)을 호출하여 이 핸들을 해제할 책임이 있습니다.

### 반환 값

형식: **HRESULT**

성공 시 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

## 설명

복사 작업을 시작하기 전에 `WdCreateCancellationHandle`을 호출하여 취소를 가능하게 하는 핸들을 얻으세요. `cancellationHandle` 매개 변수를 통해 [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)에 핸들을 전달한 다음, 작업을 취소하려면 별도의 스레드에서 [WdCancelRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdcancelremotecopy.md)에 핸들을 전달하세요.

`WdRemoteCopy`가 반환된 후에는 [WdCloseCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdclosecancellationhandle.md)을 호출하여 핸들을 닫으세요. 핸들은 여러 `WdRemoteCopy` 호출에서 재사용할 수 있지만, 결국 각 핸들은 닫아야 합니다.

## 요구 사항

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

## 함께 보기

* [WdCloseCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdclosecancellationhandle.md)
* [WdDuplicateCancellationHandle](https://docs.xbox.com/ko/reference/remoting/functions/wdduplicatecancellationhandle.md)
* [WdCancellationHandle](https://docs.xbox.com/ko/reference/remoting/structs/wdcancellationhandle.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

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