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

> Référence de WdDeleteSearchOptions, qui définit les modèles d'inclusion et d'exclusion ainsi que les filtres d'attributs permettant de sélectionner les éléments à supprimer avec WdDeleteRemoteFiles.

# WdDeleteSearchOptions

Spécifie les modèles de filtre de fichiers et de répertoires pour une opération de suppression.

**Introduite dans :** [RIT 0.0.13-preview](/fr/reference/remoting/release-versions#release-versions).

## Syntaxe

```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;
};
```

### Membres

`includeFilePattern`\
Type : **const char\***

Inclut les fichiers dont le nom correspond aux noms spécifiés. Les caractères génériques `*` et `?` sont pris en charge, et une liste de modèles peut être séparée par un point-virgule (`;`). La valeur par défaut est `nullptr`, ce qui inclut tout.

`excludeFilePattern`\
Type : **const char\***

Exclut les fichiers dont le nom correspond aux noms spécifiés. Les caractères génériques `*` et `?` sont pris en charge, et une liste de modèles peut être séparée par un point-virgule (`;`). La valeur par défaut est `nullptr`, ce qui n'exclut aucun fichier.

`excludeDirPattern`\
Type : **const char\***

Exclut les répertoires dont le nom (et non le chemin) correspond aux noms spécifiés. Les caractères génériques `*` et `?` sont pris en charge. La valeur par défaut est `nullptr`, ce qui n'exclut aucun répertoire de la suppression.

`includeFileAttributes`\
Type : **uint64\_t**

Inclut les fichiers pour lesquels l'un des attributs de fichier spécifiés est défini. Les valeurs prises en charge sont `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` et `FILE_ATTRIBUTE_HIDDEN`. La valeur par défaut est `0`, ce qui inclut tous les attributs. Pour plus d'informations sur les attributs de fichier, consultez [Constantes d'attributs de fichier](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

`excludeFileAttributes`\
Type : **uint64\_t**

Exclut les fichiers pour lesquels l'un des attributs de fichier spécifiés est défini. Les valeurs prises en charge sont `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` et `FILE_ATTRIBUTE_HIDDEN`. La valeur par défaut est `0`, ce qui n'exclut aucun attribut. Pour plus d'informations sur les attributs de fichier, consultez [Constantes d'attributs de fichier](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

`includeDirAttributes`\
Type : **uint64\_t**

Inclut les répertoires pour lesquels l'un des attributs de fichier spécifiés est défini. Les valeurs prises en charge sont `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` et `FILE_ATTRIBUTE_HIDDEN`. La valeur par défaut est `0`, ce qui inclut tous les attributs.

`excludeDirAttributes`\
Type : **uint64\_t**

Exclut les répertoires pour lesquels l'un des attributs de fichier spécifiés est défini. Les valeurs prises en charge sont `FILE_ATTRIBUTE_READONLY`, `FILE_ATTRIBUTE_ARCHIVE`, `FILE_ATTRIBUTE_SYSTEM` et `FILE_ATTRIBUTE_HIDDEN`. La valeur par défaut est `0`, ce qui n'exclut aucun attribut.

## Exemples

**Supprimer uniquement les fichiers `.pdb` et `.log` :**

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

**Tout supprimer sauf un répertoire de données d'enregistrement :**

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

**Supprimer les fichiers archivés, mais conserver les fichiers en lecture seule et les répertoires masqués :**

```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]\
> En cas de conflit entre les modèles d'inclusion et d'exclusion, le modèle d'exclusion est prioritaire et l'élément n'est pas supprimé.

## Remarques

Passez cette structure à [WdDeleteRemoteFiles](/fr/reference/remoting/functions/wddeleteremotefiles) via le paramètre `searchOptions` pour filtrer les fichiers et répertoires sélectionnés pour la suppression. Si `nullptr` est passé pour `searchOptions`, tous les éléments sont inclus sans filtrage.

Ces options s'appliquent uniquement lorsque `remoteFolderPath` correspond à un dossier. Elles sont ignorées lorsque `remoteFolderPath` correspond à un seul fichier.

Une suppression filtrée qui laisse des éléments conserve le dossier racine même lorsque `deleteRootFolder` est défini sur `true` dans [WdDeleteOptions](/fr/reference/remoting/structs/wddeleteoptions), car le dossier n'est supprimé que s'il est vide.

## Configuration requise

| Exigence | Valeur |
| - | - |
| **En-tête** | WdRemoteIteration.h |
| **Bibliothèque** | wdremoteapi.lib |
| **Système d'exploitation pris en charge** | Windows 11 et versions ultérieures |
| **Architectures prises en charge** | x64, ARM64 |

## Voir aussi

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


## Related topics

- [WdDeleteSearchOptions](/reference/remoting/structs/wddeletesearchoptions.md)
- [WdDeleteOptions](/reference/remoting/structs/wddeleteoptions.md)
- [WdDeleteRemoteFiles](/reference/remoting/functions/wddeleteremotefiles.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [WdCopySearchOptions](/reference/remoting/structs/wdcopysearchoptions.md)