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

# WdCopyFileProgressInfo

> WdCopyFileProgressInfo

# WdCopyFileProgressInfo

包含複製作業期間個別檔案的進度資訊。

## 語法

```cpp theme={null}
struct WdCopyFileProgressInfo 
{
    const char* relativeFilePath;
    const char* sourcePath;
    const char* destinationPath;
    uint64_t bytesTransferred;
    uint64_t fileSize;
};
```

### 成員

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

正在複製的檔案路徑，相對於目的地路徑的根目錄 (UTF-8)。

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

本機目錄路徑 (UTF-8)：對於 `CopyTo` 為來源，對於 `CopyFrom` 為目的地。

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

遠端檔案路徑 (UTF-8)：對於 `CopyTo` 為目的地，對於 `CopyFrom` 為來源。

`bytesTransferred`\
類型：**uint64\_t**

此檔案目前為止已傳輸的位元組數。

`fileSize`\
類型：**uint64\_t**

檔案的總大小 (以位元組為單位)。

## 備註

此結構會在 [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy) 作業期間提供給 [WdCopyFilesStatusCallback](/zh-TW/reference/remoting/callbacks/wdcopyfilesstatuscallback)。每個執行個體代表單一檔案的目前狀態。回呼會接收這些結構的陣列，自上次回呼叫用以來有進度更新的每個檔案各對應一個結構。整體作業層級的進度 (檔案總數、位元組總數) 則會另外透過 [WdCopyOperationSummary](/zh-TW/reference/remoting/structs/wdcopyoperationsummary) 結構提供。

## 需求

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

## 另請參閱

* [WdRemoteCopy](/zh-TW/reference/remoting/functions/wdremotecopy)
* [WdCopyFilesStatusCallback](/zh-TW/reference/remoting/callbacks/wdcopyfilesstatuscallback)
* [WdCopyOperationSummary](/zh-TW/reference/remoting/structs/wdcopyoperationsummary)
* [XBOX PC Remote Iteration API](/zh-TW/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyFileProgressInfo](/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members.md)
- [API XBOX PC Remote Iteration](/es/reference/remoting/remoteiteration_members.md)