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

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

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

正在复制的目录的完整目标路径（UTF-8）。

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

到目前为止，此文件已传输的字节数。

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

文件的总大小（以字节为单位）。

## 备注

此结构体在 [WdRemoteCopy](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdremotecopy.md) 操作期间提供给 [WdCopyFilesStatusCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)。每个实例表示单个文件的当前状态。回调接收一个此结构体的数组，自上次回调调用以来每个具有进度更新的文件对应一个结构体。整体操作级别的进度（文件总数、总字节数）通过 [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md) 结构体单独提供。

## 要求

| 要求 | 值 |
| - | - |
| **头文件** | WdRemoteIteration.h |
| **库** | wdremoteapi.lib |
| **支持的操作系统** | Windows 11 及更高版本 |
| **支持的体系结构** | x64、ARM64 |

## 另请参阅

* [WdRemoteCopy](https://docs.xbox.com/zh-CN/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFilesStatusCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
* [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md)
* [XBOX PC 远程迭代 API](https://docs.xbox.com/zh-CN/reference/remoting/remoteiteration_members.md)


## Related topics

- [WdCopyFilesStatusCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyOperationSummary](https://docs.xbox.com/zh-CN/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](https://docs.xbox.com/zh-CN/reference/remoting/remoteiteration_members.md)
- [WdDeleteFileProgressInfo](https://docs.xbox.com/zh-CN/reference/remoting/structs/wddeletefileprogressinfo.md)
- [WdDeleteProgressCallback](https://docs.xbox.com/zh-CN/reference/remoting/callbacks/wddeleteprogresscallback.md)