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

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 :

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

Remarques

Passez cette structure à 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, 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

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

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