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

# WdCancelRemoteDelete

> WdDeleteRemoteFiles 호출에 대한 클라이언트 대기의 취소를 시그널하는 WdCancelRemoteDelete의 구문 및 설명에 대한 참조입니다.

# WdCancelRemoteDelete

삭제 작업에 대한 클라이언트 대기의 취소를 시그널합니다.

**도입된 릴리스:** [RIT 0.0.13-preview](/ko/reference/remoting/release-versions#release-versions).

## 구문

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

### 매개 변수

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

[WdCreateCancellationHandle](/ko/reference/remoting/functions/wdcreatecancellationhandle)로 생성되어 [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles)에 전달된 취소 핸들입니다. 이 핸들을 시그널링하면 클라이언트 대기의 취소가 요청됩니다.

### 반환 값

형식: **HRESULT**

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

## 설명

블로킹 [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles) 호출의 취소를 시그널하려면 별도의 스레드에서 `WdCancelRemoteDelete`를 호출합니다. `WdCancelRemoteDelete`는 논블로킹 함수입니다. `WdDeleteRemoteFiles`가 시그널을 감지하면 대기를 중지하고 엔드포인트 완료를 확인하지 않은 채 `S_OK`를 반환합니다.

감지된 취소와 정상 완료 모두 `S_OK`를 반환하므로, 취소할 수 있는 호출자는 반환 값만으로는 결과를 판단할 수 없습니다. 두 경우를 구분해야 하는 경우(예: 사용자가 시작한 취소 후 오류 메시지를 표시하지 않거나 재시도를 건너뛰려는 경우) 자체 코드에서 취소 상태를 추적합니다.

취소는 엔드포인트에서 이미 시작된 삭제를 중지하지 않으며, 해당 삭제는 독립적으로 계속됩니다. 이미 삭제된 항목을 복원하지도 않습니다.

## 요구 사항

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

## 함께 보기

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


## Related topics

- [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles.md)
- [WdCancelRemoteCopy](/ko/reference/remoting/functions/wdcancelremotecopy.md)
- [WdCancellationHandle](/ko/reference/remoting/structs/wdcancellationhandle.md)
- [WdRemoteCopy](/ko/reference/remoting/functions/wdremotecopy.md)
- [WdCreateCancellationHandle](/ko/reference/remoting/functions/wdcreatecancellationhandle.md)