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

> WdCancelRemoteDelete 的參考資料，此函式會對 WdDeleteRemoteFiles 呼叫的用戶端等候發出取消訊號，包含語法和備註。

# WdCancelRemoteDelete

對刪除作業的用戶端等候發出取消訊號。

**引進版本：** [RIT 0.0.13-preview](/zh-TW/reference/remoting/release-versions#release-versions)。

## 語法

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

### 參數

`_In_ cancellationHandle`\
類型：**[WdCancellationHandle](/zh-TW/reference/remoting/structs/wdcancellationhandle)**

由 [WdCreateCancellationHandle](/zh-TW/reference/remoting/functions/wdcreatecancellationhandle) 建立並傳遞給 [WdDeleteRemoteFiles](/zh-TW/reference/remoting/functions/wddeleteremotefiles) 的取消控制代碼。對此控制代碼發出訊號會要求取消用戶端等候。

### 傳回值

類型：**HRESULT**

如果成功，則傳回 `S_OK`；否則傳回錯誤碼。

## 備註

從另一個執行緒呼叫 `WdCancelRemoteDelete`，以對封鎖中的 [WdDeleteRemoteFiles](/zh-TW/reference/remoting/functions/wddeleteremotefiles) 呼叫發出取消訊號。`WdCancelRemoteDelete` 是非封鎖函式。如果 `WdDeleteRemoteFiles` 觀察到該訊號，就會停止等候並傳回 `S_OK`，而不會確認端點是否完成。

由於觀察到取消和正常完成都會傳回 `S_OK`，可能取消的呼叫端無法單憑傳回值判斷結果。如果您需要區分這兩者，請在自己的程式碼中追蹤取消狀態，例如在使用者起始取消之後隱藏錯誤訊息或略過重試。

取消不會停止端點上已開始的刪除，刪除會獨立繼續進行。取消也不會還原已刪除的項目。

## 需求

| 需求 | 值 |
| - | - |
| **標頭** | WdRemoteIteration.h |
| **程式庫** | wdremoteapi.lib |
| **支援的作業系統** | Windows 11 及更新版本 |
| **支援的架構** | x64、ARM64 |

## 另請參閱

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


## Related topics

- [WdCancelRemoteDelete](/reference/remoting/functions/wdcancelremotedelete.md)
- [WdDeleteRemoteFiles](/reference/remoting/functions/wddeleteremotefiles.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy.md)
- [WdCancellationHandle](/reference/remoting/structs/wdcancellationhandle.md)