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

# WdCopyOptions

> WdCopyOptions

# WdCopyOptions

Especifica a direção e o alias da raiz comum de uma operação de cópia.

**Introduzida em:** [RIT 0.0.8-Preview](/pt-BR/reference/remoting/release-versions#release-versions).

## Sintaxe

```cpp theme={null}
struct WdCopyOptions
{
    WdCopyDirection copyDirection;
    const char* commonRootAlias;
};
```

### Membros

`copyDirection`\
Tipo: **[WdCopyDirection](/pt-BR/reference/remoting/enums/wdcopydirection)**

A direção da operação de cópia. Use `CopyTo` para enviar arquivos do PC local para o dispositivo remoto ou `CopyFrom` para obter arquivos do dispositivo remoto para o PC local. `WdCopyDirection::CopyTo` é o valor padrão se nenhum for especificado.

**Suporte a `CopyFrom` a partir de:** [RIT 0.0.13-preview](/pt-BR/reference/remoting/release-versions#release-versions). Confira o [histórico de alterações de WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy#change-history).

`commonRootAlias`\
Tipo: **const char\***

Um alias opcional para um diretório de raiz comum no dispositivo remoto (UTF-8). Se o caminho remoto (`destinationPath` para `CopyTo`, `sourcePath` para `CopyFrom`) for absoluto, `commonRootAlias` será ignorado.

## Comentários

Passe essa estrutura para [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy) para controlar o comportamento da cópia. Se `nullptr` for passado para o parâmetro `copyOptions` de `WdRemoteCopy`, a direção da cópia será `CopyTo` por padrão e o local padrão da raiz comum será usado se o caminho de destino for relativo.

As raízes comuns permitem que os usuários usem locais conhecidos pré-configurados para os quais os jogos são copiados ou a partir dos quais são iniciados, e se refiram a eles por alias em vez do caminho completo.

## Requisitos

| Requisito | Valor |
| - | - |
| **Cabeçalho** | WdRemoteIteration.h |
| **Biblioteca** | wdremoteapi.lib |
| **SO com suporte** | Windows 11 e posterior |
| **Arquiteturas com suporte** | x64, ARM64 |

## Confira também

* [WdRemoteCopy](/pt-BR/reference/remoting/functions/wdremotecopy)
* [WdCopyDirection](/pt-BR/reference/remoting/enums/wdcopydirection)
* [XBOX PC Remote Iteration API](/pt-BR/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyOptions](/reference/remoting/structs/wdcopyoptions.md)
- [WdCopyDirection](/reference/remoting/enums/wdcopydirection.md)