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

# WdDeleteOptions

> WdDeleteRemoteFiles 操作中の共通ルート エイリアスと、ルート フォルダーを削除するかどうかを設定する WdDeleteOptions のリファレンスです。

# WdDeleteOptions

リモート デバイスでの削除操作のオプションを指定します。

**導入バージョン:** [RIT 0.0.13-preview](/ja-jp/reference/remoting/release-versions#release-versions)。

## 構文

```cpp theme={null}
struct WdDeleteOptions
{
    const char* commonRootAlias;
    bool deleteRootFolder;
};
```

### メンバー

`commonRootAlias`\
Type: **const char\***

リモート デバイス上の共通ルートの場所を示す省略可能なエイリアス (UTF-8)。既定の共通ルートの場所を使用するには、`nullptr` に設定します。

`deleteRootFolder`\
Type: **bool**

`true` の場合、`remoteFolderPath` の内容が削除された後、フォルダーが空になったときに限り、そのフォルダー自体の削除が試みられます。フィルター処理された削除によって項目が残った場合、フォルダーは保持されます。`false` (既定値) の場合、`remoteFolderPath` の内容のみが削除され、フォルダー自体はそのまま残ります。`remoteFolderPath` が単一のファイルに解決される場合、このフィールドは無視されます。

このフィールドが制御するのは、`remoteFolderPath` 自体の削除のみです。値にかかわらず、この操作では、ディレクトリ フィルターを通過した空のサブディレクトリ (元から空だったディレクトリを含む) の削除を試みます。

## 解説

この構造体を `deleteOptions` パラメーターを介して [WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles) に渡します。`deleteOptions` に `nullptr` を渡した場合、`remoteFolderPath` が相対パスであれば既定の共通ルートの場所が使用され、フォルダーの内容のみが削除されます。

削除はベスト エフォートで行われます。[WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles) が正常に戻った場合でも、選択されたすべての項目やルート フォルダーが削除されたことは保証されません。

`remoteFolderPath` が絶対パスの場合、`commonRootAlias` は無視されます。`remoteFolderPath` が相対パスの場合は、エイリアスで示される共通ルートを基準として解決されます。エイリアスが指定されていない場合は、既定の共通ルートの場所を基準として解決されます。

## 要件

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

## 関連項目

* [WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles)
* [WdDeleteSearchOptions](/ja-jp/reference/remoting/structs/wddeletesearchoptions)
* [XBOX PC Remote Iteration API](/ja-jp/reference/remoting/remoteiteration_members)


## Related topics

- [WdDeleteSearchOptions](/ja-jp/reference/remoting/structs/wddeletesearchoptions.md)
- [WdDeleteRemoteFiles](/ja-jp/reference/remoting/functions/wddeleteremotefiles.md)
- [WdLaunchOptions](/ja-jp/reference/remoting/structs/wdlaunchoptions.md)
- [WdCopyOptions](/ja-jp/reference/remoting/structs/wdcopyoptions.md)
- [WdDeleteProgressCallback](/ja-jp/reference/remoting/callbacks/wddeleteprogresscallback.md)