> ## 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](/ko/reference/remoting/release-versions.md#release-versions).

## 구문

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

### 멤버

`commonRootAlias`\
형식: **const char\***

원격 디바이스의 공통 루트 위치에 대한 선택적 별칭입니다(UTF-8). 기본 공통 루트 위치를 사용하려면 `nullptr`로 설정합니다.

`deleteRootFolder`\
형식: **bool**

`true`이면 `remoteFolderPath` 폴더의 콘텐츠가 삭제된 후 해당 폴더 자체의 제거를 시도하지만, 폴더가 비어 있는 경우에만 시도합니다. 필터링된 삭제로 항목이 남아 있으면 폴더는 유지됩니다. 기본값인 `false`이면 `remoteFolderPath`의 콘텐츠만 삭제되고 폴더 자체는 그대로 유지됩니다. `remoteFolderPath`가 단일 파일로 확인되면 이 필드는 무시됩니다.

이 필드는 `remoteFolderPath` 자체의 제거만 제어합니다. 이 값과 관계없이, 작업은 디렉터리 필터를 통과하는 빈 하위 디렉터리(이미 비어 있던 디렉터리 포함)의 제거를 시도합니다.

## 설명

이 구조체를 `deleteOptions` 매개 변수를 통해 [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles.md)에 전달합니다. `deleteOptions`에 `nullptr`을 전달하면 `remoteFolderPath`가 상대 경로일 때 기본 공통 루트 위치가 사용되며, 폴더의 콘텐츠만 삭제됩니다.

삭제는 최선의 방식으로 수행됩니다. [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles.md)가 성공적으로 반환되더라도 선택된 모든 항목이나 루트 폴더가 제거되었음을 보장하지는 않습니다.

`remoteFolderPath`가 절대 경로인 경우 `commonRootAlias`는 무시됩니다. `remoteFolderPath`가 상대 경로인 경우 별칭으로 식별된 공통 루트를 기준으로 확인되며, 별칭이 지정되지 않은 경우 기본 공통 루트 위치를 기준으로 확인됩니다.

## 요구 사항

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

## 함께 보기

* [WdDeleteRemoteFiles](/ko/reference/remoting/functions/wddeleteremotefiles.md)
* [WdDeleteSearchOptions](/ko/reference/remoting/structs/wddeletesearchoptions.md)
* [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)


## Related topics

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