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.

Syntaxe

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 qui correspondent 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, qui inclut tout. excludeFilePattern
Type : const char* Exclut les fichiers qui correspondent 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, qui n’exclut aucun fichier. excludeDirPattern
Type : const char* Exclut les répertoires qui correspondent aux noms spécifiés, et non aux chemins. Les caractères génériques * et ? sont pris en charge. La valeur par défaut est nullptr, 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, qui inclut tous les attributs. Pour obtenir plus d’informations sur les attributs de fichier, consultez Constantes d’attributs de fichier. 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, qui n’exclut aucun attribut. Pour obtenir plus d’informations sur les attributs de fichier, consultez Constantes d’attributs de fichier. 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, 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, qui n’exclut aucun attribut.

Exemples

Supprimer uniquement les fichiers .pdb et .log :

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 de sauvegarde :

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 :

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 a priorité et l’élément n’est pas supprimé.

Remarques

Transmettez cette structure à WdDeleteRemoteFiles au moyen du paramètre searchOptions pour filtrer les fichiers et répertoires sélectionnés pour la suppression. Si nullptr est transmis 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 en place conserve le dossier racine même lorsque deleteRootFolder est réglé à true dans 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
SE pris en charge	Windows 11 et versions ultérieures
Architectures prises en charge	x64, ARM64

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

WdDeleteSearchOptions

WdDeleteSearchOptions

Syntaxe

Membres

Exemples

Remarques

Configuration requise

Voir aussi

​WdDeleteSearchOptions

​Syntaxe

​Membres

​Exemples

​Remarques

​Configuration requise

​Voir aussi

WdDeleteSearchOptions

Syntaxe

Membres

Exemples

Remarques

Configuration requise

Voir aussi