WdCopySearchOptions

Spécifie des modèles de filtre de fichiers et de répertoires pour 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 affectent 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* Modèle glob spécifiant 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* Modèle glob spécifiant 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* Modèle glob spécifiant 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 Visual Studio et de sortie de build). includeFileAttributes
Type : uint32_t Masque de bits d’attributs de fichier. Les fichiers possédant l’un des attributs spécifiés sont inclus dans la copie. Définissez la valeur 0 pour ne pas filtrer par attributs. Pour plus d’informations sur les attributs de fichier, consultez Constantes d’attributs de fichier. excludeFileAttributes
Type : uint32_t Masque de bits d’attributs de fichier entraînant l’exclusion des fichiers de la copie. Définissez la valeur 0 pour ne pas filtrer par attributs. Pour plus d’informations sur les attributs de fichier, consultez Constantes d’attributs de fichier. includeDirectoryAttributes
Type : uint32_t Introduit dans : RIT 0.0.13-preview. Masque de bits d’attributs de répertoire. Les répertoires possédant l’un 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 par attributs. excludeDirectoryAttributes
Type : uint32_t Introduit dans : RIT 0.0.13-preview. Masque de bits d’attributs de répertoire entraînant l’exclusion des répertoires de la copie. Équivaut à excludeFileAttributes appliqué aux répertoires. Définissez la valeur 0 pour ne pas filtrer par 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 masqué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 masqué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 est prioritaire et le fichier n’est pas copié.

Remarques

Passez cette structure à WdRemoteCopy via le 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 de `includeFileAttributes` et `excludeFileAttributes` de `uint64_t` en `uint32_t`. Ajout de `includeDirectoryAttributes` et `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

(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

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