WdCopySearchOptions

Spécifie les modèles de filtre de fichiers et de répertoires d’une opération de copie. Introduit dans : RIT 0.0.8-Preview. Les types et la disponibilité des membres varient selon la version; consultez Historique des modifications.

Pour CopyFrom, les modèles de noms touchent uniquement l’énumération delta locale; ils ne restreignent pas la sélection des fichiers distants.

Syntaxe

struct WdCopySearchOptions 
{ 
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint32_t includeFileAttributes;
    uint32_t excludeFileAttributes;
    uint32_t includeDirectoryAttributes;
    uint32_t excludeDirectoryAttributes;
};

Membres

_In_z_ includeFilePattern
Type : const char* Un modèle glob qui spécifie les fichiers à inclure dans l’opération de copie (par exemple, "*" pour inclure tous les fichiers, ou "*.exe;*.dll" pour inclure uniquement les exécutables et les DLL). _In_z_ excludeFilePattern
Type : const char* Un modèle glob qui spécifie les fichiers à exclure de l’opération de copie (par exemple, "*.pdb" pour exclure les symboles de débogage). _In_z_ excludeDirPattern
Type : const char* Un modèle glob qui spécifie des noms de répertoires, et non des chemins, à exclure de l’opération de copie (par exemple, ".vs;obj" pour exclure les répertoires de Visual Studio et de sortie de build). includeFileAttributes
Type : uint32_t Un masque de bits d’attributs de fichier. Les fichiers possédant l’un ou l’autre des attributs spécifiés sont inclus dans la copie. Définissez la valeur à 0 pour ne pas filtrer selon les attributs. Pour plus d’information sur les attributs de fichier, consultez File Attribute Constants. excludeFileAttributes
Type : uint32_t Un masque de bits d’attributs de fichier qui entraînent l’exclusion des fichiers de la copie. Définissez la valeur à 0 pour ne pas filtrer selon les attributs. Pour plus d’information sur les attributs de fichier, consultez File Attribute Constants. includeDirectoryAttributes
Type : uint32_t Introduit dans : RIT 0.0.13-preview. Un masque de bits d’attributs de répertoire. Les répertoires possédant l’un ou l’autre des attributs spécifiés sont inclus dans la copie. Équivaut à includeFileAttributes appliqué aux répertoires. Définissez la valeur à 0 pour ne pas filtrer selon les attributs. excludeDirectoryAttributes
Type : uint32_t Introduit dans : RIT 0.0.13-preview. Un masque de bits d’attributs de répertoire qui entraînent l’exclusion des répertoires de la copie. Équivaut à excludeFileAttributes appliqué aux répertoires. Définissez la valeur à 0 pour ne pas filtrer selon les attributs.

Exemples

Les exemples de modèles de noms ci-dessous utilisent CopyTo. Copier uniquement les fichiers .exe et .dll :

WdCopySearchOptions searchOptions = {
    .includeFilePattern = "*.exe;*.dll",
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

Exclure de la copie les répertoires nommés temp :

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = "temp",
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

Copier uniquement les fichiers en lecture seule ou système, et exclure les fichiers cachés :

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_SYSTEM,
    .excludeFileAttributes = FILE_ATTRIBUTE_HIDDEN,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = 0
};

Ignorer uniquement les répertoires cachés :

WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0,
    .includeDirectoryAttributes = 0,
    .excludeDirectoryAttributes = FILE_ATTRIBUTE_HIDDEN
};

En cas de conflit entre les modèles d’inclusion et d’exclusion, le modèle d’exclusion a priorité et le fichier n’est pas copié.

Remarques

Passez cette structure à WdRemoteCopy au moyen du paramètre searchOptions pour filtrer les fichiers et répertoires inclus dans l’opération de copie. Si nullptr est passé pour searchOptions, tous les fichiers sont copiés sans filtrage.

Historique des modifications

Version	Modification
RIT 0.0.13-preview	Modification du type de `includeFileAttributes` et de `excludeFileAttributes`, de `uint64_t` à `uint32_t`. Ajout de `includeDirectoryAttributes` et de `excludeDirectoryAttributes`, tous deux de type `uint32_t`.
RIT 0.0.8-Preview	Introduction des trois champs de modèles de noms et de deux masques d’attributs de fichier `uint64_t`.

Les modifications de RIT 0.0.13-preview changent la disposition de la structure. Régénérez les appelants natifs avec l’en-tête et la bibliothèque du package NuGet de l’API correspondant; ne passez pas l’ancienne disposition de la structure à la DLL de l’API plus récente.

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

WdCopySearchOptions

WdCopySearchOptions

Syntaxe

Membres

Exemples

Remarques

Historique des modifications

Configuration requise

Voir aussi

​WdCopySearchOptions

​Syntaxe

​Membres

​Exemples

​Remarques

​Historique des modifications

​Configuration requise

​Voir aussi

WdCopySearchOptions

Syntaxe

Membres

Exemples

Remarques

Historique des modifications

Configuration requise

Voir aussi