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

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

## 구문

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

### 멤버

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

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

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

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

## 설명

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

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

## 요구 사항

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

## 함께 보기

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


## Related topics

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