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

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

복사 중인 디렉터리의 전체 대상 경로입니다(UTF-8).

`bytesTransferred`\
형식: **uint64\_t**

이 파일에 대해 지금까지 전송된 바이트 수입니다.

`fileSize`\
형식: **uint64\_t**

파일의 총 크기(바이트)입니다.

## 설명

이 구조체는 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy) 작업 도중 [WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)에 전달됩니다. 각 인스턴스는 단일 파일의 현재 상태를 나타냅니다. 콜백은 이러한 구조체의 배열을 수신하며, 마지막 콜백 호출 이후 진행 상황 업데이트가 있는 각 파일마다 하나씩 포함됩니다. 전체 작업 수준의 진행 상황(전체 파일 수, 전체 바이트 수)은 [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary) 구조체를 통해 별도로 제공됩니다.

## 요구 사항

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

## 함께 보기

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


## Related topics

- [WdCopyFilesStatusCallback](/ko/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyOperationSummary](/ko/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)
- [WdCopyStatusCallbacks](/ko/reference/remoting/structs/wdcopystatuscallbacks.md)
- [IXtfCopyFileCallback::OnFileCopyProgress 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)