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

# WdCancelRemoteCopy

> WdCancelRemoteCopy

# WdCancelRemoteCopy

진행 중인 복사 작업을 취소합니다.

## 구문

```cpp theme={null}
HRESULT WdCancelRemoteCopy(  
         _In_ WdCancellationHandle cancellationHandle  
);  
```

### 매개 변수

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

[WdCreateCancellationHandle](/reference/remoting/functions/wdcreatecancellationhandle)로 생성되어 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)에 전달된 취소 핸들입니다. 이 핸들을 시그널링하면 진행 중인 복사가 취소됩니다.

### 반환 값

형식: **HRESULT**

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

## 설명

블로킹 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy) 호출을 취소하려면 별도의 스레드에서 `WdCancelRemoteCopy`를 호출하세요. `WdCancelRemoteCopy`는 논블로킹 함수입니다. 취소가 시그널되면 `WdRemoteCopy`는 복사를 취소하고 `S_OK`를 반환합니다.

## 요구 사항

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

## 함께 보기

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCancellationHandle](/reference/remoting/structs/wdcancellationhandle)
* [WdCreateCancellationHandle](/reference/remoting/functions/wdcreatecancellationhandle)
* [WdCloseCancellationHandle](/reference/remoting/functions/wdclosecancellationhandle)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdRemoteCopy](/ko/reference/remoting/functions/wdremotecopy.md)
- [WdCancellationHandle](/ko/reference/remoting/structs/wdcancellationhandle.md)
- [WdCreateCancellationHandle](/ko/reference/remoting/functions/wdcreatecancellationhandle.md)
- [WdDuplicateCancellationHandle](/ko/reference/remoting/functions/wdduplicatecancellationhandle.md)
- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)
