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

Specifies the direction and common root alias for a copy operation.

## Syntax

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

### Members

`copyDirection`\
Type: **[WdCopyDirection](/reference/remoting/enums/wdcopydirection)**

The direction of the copy operation. Use `CopyTo` to push files from the local PC to the remote device, or `CopyFrom` to pull files from the remote device to the local PC. `WdCopyDirection::CopyTo` is the default value if not specified.

`commonRootAlias`\
Type: **const char\***

An optional alias for a common root directory on the remote device (UTF-8). If `destinationPath` is an absolute path, `commonRootAlias` will be ignored.

## Remarks

Pass this structure to [WdRemoteCopy](/reference/remoting/functions/wdremotecopy) to control the copy behavior. If `nullptr` is passed for the `copyOptions` parameter of `WdRemoteCopy`, the copy direction defaults to `CopyTo` and the default common root location is used if the destination path is relative.

Common roots allow users to use pre-configured known locations where games are copied to or launched from, and refer to them by alias instead of full path.

## Requirements

| Requirement                 | Value                |
| --------------------------- | -------------------- |
| **Header**                  | WdRemoteIteration.h  |
| **Library**                 | wdremoteapi.lib      |
| **Supported OS**            | Windows 11 and later |
| **Supported architectures** | x64, ARM64           |

## See also

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


## Related topics

- [WdCopyDirection](/reference/remoting/enums/wdcopydirection.md)
- [WdRemoteCopy](/reference/remoting/functions/wdremotecopy.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [WdCopySearchOptions](/reference/remoting/structs/wdcopysearchoptions.md)
- [WdCancelRemoteCopy](/reference/remoting/functions/wdcancelremotecopy.md)