WdCopySearchOptions

Especifica los patrones de filtro de archivos y directorios para una operación de copia. Introducido en: RIT 0.0.8-Preview. Los tipos de miembros y su disponibilidad varían según la versión; consulte Historial de cambios.

Para CopyFrom, los patrones de nombre solo afectan a la enumeración diferencial local; no restringen la selección de archivos remotos.

Sintaxis

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

Miembros

_In_z_ includeFilePattern
Tipo: const char* Patrón glob que especifica qué archivos se incluyen en la operación de copia (por ejemplo, "*" para incluir todos los archivos, o "*.exe;*.dll" para incluir solo ejecutables y archivos DLL). _In_z_ excludeFilePattern
Tipo: const char* Patrón glob que especifica qué archivos se excluyen de la operación de copia (por ejemplo, "*.pdb" para excluir los símbolos de depuración). _In_z_ excludeDirPattern
Tipo: const char* Patrón glob que especifica nombres de directorio, no rutas de acceso, que se excluyen de la operación de copia (por ejemplo, ".vs;obj" para excluir los directorios de Visual Studio y de salida de compilación). includeFileAttributes
Tipo: uint32_t Máscara de bits de atributos de archivo. Los archivos con cualquiera de los atributos especificados se incluyen en la copia. Establézcala en 0 para no filtrar por atributos. Para obtener más información sobre los atributos de archivo, consulte Constantes de atributos de archivo. excludeFileAttributes
Tipo: uint32_t Máscara de bits de atributos de archivo que hacen que los archivos se excluyan de la copia. Establézcala en 0 para no filtrar por atributos. Para obtener más información sobre los atributos de archivo, consulte Constantes de atributos de archivo. includeDirectoryAttributes
Tipo: uint32_t Introducido en: RIT 0.0.13-preview. Máscara de bits de atributos de directorio. Los directorios con cualquiera de los atributos especificados se incluyen en la copia. Es lo mismo que includeFileAttributes aplicado a directorios. Establézcala en 0 para no filtrar por atributos. excludeDirectoryAttributes
Tipo: uint32_t Introducido en: RIT 0.0.13-preview. Máscara de bits de atributos de directorio que hacen que los directorios se excluyan de la copia. Es lo mismo que excludeFileAttributes aplicado a directorios. Establézcala en 0 para no filtrar por atributos.

Ejemplos

Los siguientes ejemplos de patrones de nombre usan CopyTo. Copiar solo archivos .exe y .dll:

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

Excluir de la copia los directorios denominados temp:

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

Copiar solo archivos de solo lectura o del sistema y excluir los archivos ocultos:

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

Omitir solo los directorios ocultos:

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

Cuando hay un conflicto entre los patrones de inclusión y exclusión, el patrón de exclusión tiene prioridad y el archivo no se copia.

Comentarios

Pase esta estructura a WdRemoteCopy mediante el parámetro searchOptions para filtrar qué archivos y directorios se incluyen en la operación de copia. Si se pasa nullptr para searchOptions, se copian todos los archivos sin filtrar.

Historial de cambios

Versión	Cambio
RIT 0.0.13-preview	Se cambiaron `includeFileAttributes` y `excludeFileAttributes` de `uint64_t` a `uint32_t`. Se agregaron `includeDirectoryAttributes` y `excludeDirectoryAttributes`, ambos de tipo `uint32_t`.
RIT 0.0.8-Preview	Se introdujeron los tres campos de patrón de nombre y dos máscaras de atributos de archivo `uint64_t`.

Los cambios de RIT 0.0.13-preview alteran el diseño de la estructura. Vuelva a compilar los autores de llamadas nativos con el encabezado y la biblioteca del paquete NuGet de la API correspondiente; no pase el diseño de estructura anterior al archivo DLL de la API más reciente.

Requisitos

Requisito	Valor
Encabezado	WdRemoteIteration.h
Biblioteca	wdremoteapi.lib
Sistemas operativos compatibles	Windows 11 y versiones posteriores
Arquitecturas compatibles	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

Sintaxis

Miembros

Ejemplos

Comentarios

Historial de cambios

Requisitos

Consulte también

​WdCopySearchOptions

​Sintaxis

​Miembros

​Ejemplos

​Comentarios

​Historial de cambios

​Requisitos

​Consulte también

WdCopySearchOptions

Sintaxis

Miembros

Ejemplos

Comentarios

Historial de cambios

Requisitos

Consulte también