> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WdCopySearchOptions

> WdCopySearchOptions

# WdCopySearchOptions

Especifica los patrones de filtro de archivos y directorios para una operación de copia.

## Sintaxis

```cpp theme={null}
struct WdCopySearchOptions 
{ 
    const char* includeFilePattern;
    const char* excludeFilePattern;
    const char* excludeDirPattern;
    uint64_t includeFileAttributes;
    uint64_t excludeFileAttributes;
};
```

### Miembros

`_In_z_ includeFilePattern`\
Tipo: **const char\***

Patrón glob que especifica qué archivos se deben incluir en la operación de copia (por ejemplo, `"*"` para incluir todos los archivos, o `"*.exe;*.dll"` para incluir solo los ejecutables y los archivos DLL).

`_In_z_ excludeFilePattern`\
Tipo: **const char\***

Patrón glob que especifica qué archivos se deben excluir 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 qué directorios se deben excluir 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: **uint64\_t**

Máscara de bits de los atributos de archivo que los archivos deben tener para incluirse en la copia. Establézcala en `0` para no filtrar por atributos. Para obtener información adicional sobre los atributos de archivo, consulte [File Attribute Constants](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

`excludeFileAttributes`\
Tipo: **uint64\_t**

Máscara de bits de los atributos de archivo que hacen que los archivos se excluyan de la copia. Establézcala en `0` para no filtrar por atributos. Para obtener información adicional sobre los atributos de archivo, consulte [File Attribute Constants](https://learn.microsoft.com/windows/win32/fileio/file-attribute-constants).

## Ejemplos

**Copiar solo los archivos `.exe` y `.dll`:**

```cpp theme={null}
WdCopySearchOptions searchOptions = {
    .includeFilePattern = "*.exe;*.dll",
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0
};
```

**Excluir de la copia los directorios denominados `temp`:**

```cpp theme={null}
WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = "temp",
    .includeFileAttributes = 0,
    .excludeFileAttributes = 0
};
```

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

```cpp theme={null}
WdCopySearchOptions searchOptions = {
    .includeFilePattern = nullptr,
    .excludeFilePattern = nullptr,
    .excludeDirPattern = nullptr,
    .includeFileAttributes = FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_SYSTEM,
    .excludeFileAttributes = FILE_ATTRIBUTE_HIDDEN
};
```

<Note>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 copiará.</Note>

## Comentarios

Pase esta estructura a [WdRemoteCopy](/reference/remoting/functions/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 filtrado.

## Requisitos

| Requisito                           | Valor                              |
| ----------------------------------- | ---------------------------------- |
| **Encabezado**                      | WdRemoteIteration.h                |
| **Biblioteca**                      | wdremoteapi.lib                    |
| **Sistemas operativos compatibles** | Windows 11 y versiones posteriores |
| **Arquitecturas compatibles**       | x64, ARM64                         |

## Consulte también

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [API XBOX PC Remote Iteration](/reference/remoting/remoteiteration_members)