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

# WdCreateCancellationHandle

> WdCreateCancellationHandle

# WdCreateCancellationHandle

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

## 구문

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

### 매개 변수

`_Out_ cancellationHandle`\
형식: **[WdCancellationHandle](/reference/remoting/structs/wdcancellationhandle)\***

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

### 반환 값

형식: **HRESULT**

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

## 설명

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

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

## 요구 사항

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

## 함께 보기

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


## Related topics

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