> ## 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](/ja-jp/reference/remoting/release-versions#release-versions)。

## 構文

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

### パラメーター

`_In_ cancellationHandle`\
Type: **[WdCancellationHandle](/ja-jp/reference/remoting/structs/wdcancellationhandle)**

[WdCreateCancellationHandle](/ja-jp/reference/remoting/functions/wdcreatecancellationhandle) で作成し、[WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles) に渡されたキャンセル ハンドル。このハンドルにシグナルを送ると、クライアントの待機のキャンセルが要求されます。

### 戻り値

Type: **HRESULT**

成功した場合は `S_OK` を返します。それ以外の場合はエラー コードを返します。

## 解説

ブロッキングされている [WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles) 呼び出しのキャンセルをシグナルするには、別のスレッドから `WdCancelRemoteDelete` を呼び出します。`WdCancelRemoteDelete` は非ブロッキング関数です。`WdDeleteRemoteFiles` がシグナルを検知すると、待機を停止し、エンドポイントでの完了を確認せずに `S_OK` を返します。

キャンセルが検知された場合も通常どおり完了した場合も `S_OK` が返されるため、キャンセルする可能性のある呼び出し元は、戻り値だけでは結果を判断できません。この 2 つを区別する必要がある場合 (たとえば、ユーザーが開始したキャンセルの後にエラー メッセージを表示しないようにしたり、再試行をスキップしたりする場合) は、独自のコードでキャンセル状態を追跡してください。

キャンセルしても、エンドポイントで既に開始された削除は停止されず、独立して続行されます。また、既に削除された項目は復元されません。

## 要件

| 要件 | 値 |
| - | - |
| **ヘッダー** | WdRemoteIteration.h |
| **ライブラリ** | wdremoteapi.lib |
| **サポートされている OS** | Windows 11 以降 |
| **サポートされているアーキテクチャ** | x64、ARM64 |

## 関連項目

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


## Related topics

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