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

指定複製作業的方向和通用根目錄別名。

**推出版本：** [RIT 0.0.8-Preview](/zh-TW/reference/remoting/release-versions#release-versions)。

## 語法

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

### 成員

`copyDirection`\
類型：**[WdCopyDirection](/zh-TW/reference/remoting/enums/wdcopydirection)**

複製作業的方向。使用 `CopyTo` 將檔案從本機 PC 推送到遠端裝置，或使用 `CopyFrom` 將檔案從遠端裝置提取到本機 PC。若未指定，預設值為 `WdCopyDirection::CopyTo`。

**`CopyFrom` 支援起始版本：** [RIT 0.0.13-preview](/zh-TW/reference/remoting/release-versions#release-versions)。請參閱 [WdRemoteCopy 變更歷程記錄](/zh-TW/reference/remoting/functions/wdremotecopy#change-history)。

`commonRootAlias`\
類型：**const char\***

遠端裝置上通用根目錄的選用別名 (UTF-8)。如果遠端路徑 (`CopyTo` 為 `destinationPath`，`CopyFrom` 為 `sourcePath`) 是絕對路徑，則會忽略 `commonRootAlias`。

## 備註

將此結構傳遞給 [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy) 以控制複製行為。如果為 `WdRemoteCopy` 的 `copyOptions` 參數傳遞 `nullptr`，複製方向預設為 `CopyTo`，且若目的地路徑為相對路徑，則會使用預設的通用根目錄位置。

通用根目錄可讓使用者使用預先設定的已知位置 (遊戲會複製到這些位置或從這些位置啟動)，並以別名而非完整路徑來參考這些位置。

## 需求

| 需求 | 值 |
| - | - |
| **標頭** | WdRemoteIteration.h |
| **程式庫** | wdremoteapi.lib |
| **支援的作業系統** | Windows 11 及更新版本 |
| **支援的架構** | x64, ARM64 |

## 另請參閱

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


## Related topics

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