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

# WdCopyOptions

> WdCopyOptions

# WdCopyOptions

복사 작업의 방향과 공통 루트 별칭을 지정합니다.

## 구문

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

### 멤버

`copyDirection`\
형식: **[WdCopyDirection](https://docs.xbox.com/ko/reference/remoting/enums/wdcopydirection.md)**

복사 작업의 방향입니다. 로컬 PC에서 원격 디바이스로 파일을 푸시하려면 `CopyTo`를 사용하고, 원격 디바이스에서 로컬 PC로 파일을 풀하려면 `CopyFrom`을 사용합니다. 지정되지 않은 경우 기본값은 `WdCopyDirection::CopyTo`입니다.

`commonRootAlias`\
형식: **const char\***

원격 디바이스의 공통 루트 디렉터리에 대한 선택적 별칭입니다(UTF-8). `destinationPath`가 절대 경로인 경우 `commonRootAlias`는 무시됩니다.

## 설명

이 구조체를 [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)에 전달하여 복사 동작을 제어합니다. `WdRemoteCopy`의 `copyOptions` 매개 변수로 `nullptr`을 전달하면 복사 방향은 기본값 `CopyTo`가 되며, 대상 경로가 상대 경로인 경우 기본 공통 루트 위치가 사용됩니다.

공통 루트를 사용하면 사용자가 게임이 복사되거나 실행되는 미리 구성된 알려진 위치를 사용하고, 전체 경로 대신 별칭으로 참조할 수 있습니다.

## 요구 사항

| 요구 사항 | 값 |
| - | - |
| **헤더** | WdRemoteIteration.h |
| **라이브러리** | wdremoteapi.lib |
| **지원 OS** | Windows 11 이상 |
| **지원 아키텍처** | x64, ARM64 |

## 함께 보기

* [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)
* [WdCopyDirection](https://docs.xbox.com/ko/reference/remoting/enums/wdcopydirection.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/ko/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdCopyDirection](https://docs.xbox.com/ko/reference/remoting/enums/wdcopydirection.md)
- [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/ko/reference/remoting/remoteiteration_members.md)
- [WdCopySearchOptions](https://docs.xbox.com/ko/reference/remoting/structs/wdcopysearchoptions.md)
- [WdDeleteRemoteFiles](https://docs.xbox.com/ko/reference/remoting/functions/wddeleteremotefiles.md)