> ## 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`\
Type: **[WdCopyDirection](/reference/remoting/enums/wdcopydirection)**

コピー操作の方向。ローカル PC からリモート デバイスにファイルをプッシュするには `CopyTo` を、リモート デバイスからローカル PC にファイルをプルするには `CopyFrom` を使用します。指定しない場合、既定値は `WdCopyDirection::CopyTo` です。

`commonRootAlias`\
Type: **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](/ja-jp/reference/remoting/enums/wdcopydirection.md)
- [WdRemoteCopy](/ja-jp/reference/remoting/functions/wdremotecopy.md)
- [XBOX PC Remote Iteration API](/ja-jp/reference/remoting/remoteiteration_members.md)
- [WdCopySearchOptions](/ja-jp/reference/remoting/structs/wdcopysearchoptions.md)
- [WdCopyErrorCallback](/ja-jp/reference/remoting/callbacks/wdcopyerrorcallback.md)