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

> Referência para WdDeleteOptions, que define o alias da raiz comum e se a pasta raiz deve ser excluída durante uma operação de WdDeleteRemoteFiles.

# WdDeleteOptions

Especifica opções para uma operação de exclusão em um dispositivo remoto.

**Introduzida em:** [RIT 0.0.13-preview](/pt-BR/reference/remoting/release-versions#release-versions).

## Sintaxe

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

### Membros

`commonRootAlias`\
Tipo: **const char\***

Um alias opcional para um local de raiz comum no dispositivo remoto (UTF-8). Defina como `nullptr` para usar o local de raiz comum padrão.

`deleteRootFolder`\
Tipo: **bool**

Quando `true`, a remoção da própria pasta `remoteFolderPath` é tentada depois que seu conteúdo é excluído, mas somente se ela ficar vazia. Uma exclusão filtrada que deixa itens para trás preserva a pasta. Quando `false`, que é o padrão, somente o conteúdo de `remoteFolderPath` é excluído e a própria pasta é mantida. Este campo é ignorado quando `remoteFolderPath` é resolvido para um único arquivo.

Este campo controla somente a remoção do próprio `remoteFolderPath`. Independentemente do seu valor, a operação tenta remover subdiretórios vazios que passam pelos filtros de diretório, incluindo diretórios que já estavam vazios.

## Comentários

Passe esta estrutura para [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles) por meio do parâmetro `deleteOptions`. Se `nullptr` for passado para `deleteOptions`, o local de raiz comum padrão será usado quando `remoteFolderPath` for um caminho relativo, e somente o conteúdo da pasta será excluído.

A exclusão é feita na base do melhor esforço. Um retorno bem-sucedido de [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles) não garante que todos os itens selecionados ou a pasta raiz tenham sido removidos.

Se `remoteFolderPath` for um caminho absoluto, `commonRootAlias` será ignorado. Se `remoteFolderPath` for um caminho relativo, ele será resolvido em relação à raiz comum identificada pelo alias ou em relação ao local de raiz comum padrão quando nenhum alias for especificado.

## Requisitos

| Requisito | Valor |
| - | - |
| **Cabeçalho** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **SO com suporte** | Windows 11 e posterior |
| **Arquiteturas com suporte** | x64, ARM64 |

## Confira também

* [WdDeleteRemoteFiles](/pt-BR/reference/remoting/functions/wddeleteremotefiles)
* [WdDeleteSearchOptions](/pt-BR/reference/remoting/structs/wddeletesearchoptions)
* [API de Iteração Remota do XBOX PC](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [WdDeleteOptions](/reference/remoting/structs/wddeleteoptions.md)
- [WdDeleteSearchOptions](/reference/remoting/structs/wddeletesearchoptions.md)
- [WdDeleteRemoteFiles](/reference/remoting/functions/wddeleteremotefiles.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [XBOX PC Remote (wdRemote.exe)](/tools/tools-pc/commandlinetools/gr-wdRemote.md)