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

# WdDeleteSearchOptions

> Referencia de WdDeleteSearchOptions, que establece patrones de inclusión y exclusión y filtros de atributos que seleccionan los elementos que se eliminan con WdDeleteRemoteFiles.

# WdDeleteSearchOptions

Especifica los patrones de filtro de archivos y directorios para una operación de eliminación.

**Introducido en:** [RIT 0.0.13-preview](/es/reference/remoting/release-versions#release-versions).

## Sintaxis

```cpp theme={null}
struct WdDeleteSearchOptions
{
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint64_t includeFileAttributes;
    uint64_t excludeFileAttributes;
    uint64_t includeDirAttributes;
    uint64_t excludeDirAttributes;
};
```

### Miembros

`includeFilePattern`\
Tipo: **const char\***

Incluye los archivos que coinciden con los nombres especificados. Se admiten los caracteres comodín `*` y `?`, y una lista de patrones se puede separar con punto y coma (`;`). El valor predeterminado es `nullptr`, que incluye todo.

`excludeFilePattern`\
Tipo: **const char\***

Excluye los archivos que coinciden con los nombres especificados. Se admiten los caracteres comodín `*` y `?`, y una lista de patrones se puede separar con punto y coma (`;`). El valor predeterminado es `nullptr`, que no excluye ningún archivo.

`excludeDirPattern`\
Tipo: **const char\***

Excluye los directorios que coinciden con los nombres especificados, no con rutas de acceso. Se admiten los caracteres comodín `*` y `?`. El valor predeterminado es `nullptr`, que no excluye ningún directorio de la eliminación.

`includeFileAttributes`\
Tipo: **uint64\_t**

Incluye los archivos que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` y `FILE_ATTRIBUTE_HIDDEN`. El valor predeterminado es `0`, que incluye todos los atributos. Para obtener más información sobre los atributos de archivo, consulte [Constantes de atributos de archivo](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

`excludeFileAttributes`\
Tipo: **uint64\_t**

Excluye los archivos que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` y `FILE_ATTRIBUTE_HIDDEN`. El valor predeterminado es `0`, que no excluye ningún atributo. Para obtener más información sobre los atributos de archivo, consulte [Constantes de atributos de archivo](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

`includeDirAttributes`\
Tipo: **uint64\_t**

Incluye los directorios que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` y `FILE_ATTRIBUTE_HIDDEN`. El valor predeterminado es `0`, que incluye todos los atributos.

`excludeDirAttributes`\
Tipo: **uint64\_t**

Excluye los directorios que tienen establecido cualquiera de los atributos de archivo especificados. Los valores admitidos son `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` y `FILE_ATTRIBUTE_HIDDEN`. El valor predeterminado es `0`, que no excluye ningún atributo.

## Ejemplos

**Eliminar solo archivos `.pdb` y `.log`:**

```cpp theme={null}
WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = "*.pdb;*.log",
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirAttributes = 0,
    .excludeDirAttributes = 0
};
```

**Eliminar todo excepto un directorio de datos guardados:**

```cpp theme={null}
WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = "SaveData",
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirAttributes = 0,
    .excludeDirAttributes = 0
};
```

**Eliminar los archivos archivados, pero conservar los archivos de solo lectura y los directorios ocultos:**

```cpp theme={null}
WdDeleteSearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = FILE_ATTRIBUTE_ARCHIVE,
    .excludeFileAttributes = FILE_ATTRIBUTE_READONLY,
    .includeDirAttributes = 0,
    .excludeDirAttributes = FILE_ATTRIBUTE_HIDDEN
};
```

> \[!NOTE]\
> Cuando hay un conflicto entre los patrones de inclusión y exclusión, el patrón de exclusión tiene prioridad y el elemento no se elimina.

## Comentarios

Pase esta estructura a [WdDeleteRemoteFiles](/es/reference/remoting/functions/wddeleteremotefiles) mediante el parámetro `searchOptions` para filtrar qué archivos y directorios se seleccionan para eliminarlos. Si se pasa `nullptr` para `searchOptions`, se incluyen todos los elementos sin filtrar.

Estas opciones solo se aplican cuando `remoteFolderPath` se resuelve en una carpeta. Se omiten cuando `remoteFolderPath` se resuelve en un solo archivo.

Una eliminación filtrada que deja elementos conserva la carpeta raíz incluso cuando `deleteRootFolder` está establecido en `true` en [WdDeleteOptions](/es/reference/remoting/structs/wddeleteoptions), porque la carpeta solo se quita si queda vacía.

## Requisitos

| Requisito | Valor |
| - | - |
| **Encabezado** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **Sistemas operativos compatibles** | Windows 11 y versiones posteriores |
| **Arquitecturas compatibles** | x64, ARM64 |

## Consulte también

* [WdDeleteRemoteFiles](/es/reference/remoting/functions/wddeleteremotefiles)
* [WdDeleteOptions](/es/reference/remoting/structs/wddeleteoptions)
* [API XBOX PC Remote Iteration](/es/reference/remoting/remoteiteration_members)


## Related topics

- [WdDeleteOptions](/es/reference/remoting/structs/wddeleteoptions.md)
- [WdDeleteRemoteFiles](/es/reference/remoting/functions/wddeleteremotefiles.md)
- [WdCopySearchOptions](/es/reference/remoting/structs/wdcopysearchoptions.md)
- [WdRemoteCopy](/es/reference/remoting/functions/wdremotecopy.md)
- [WdCopyOptions](/es/reference/remoting/structs/wdcopyoptions.md)