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

# WdCopyFilesStatusCallback

> WdCopyFilesStatusCallback

# WdCopyFilesStatusCallback

복사 작업 중 파일 복사 진행률을 보고하기 위해 호출됩니다.

## 구문

```cpp theme={null}
typedef HRESULT (*WdCopyFilesStatusCallback)(
    _In_ size_t fileProgressCount,
    _In_reads_opt_(fileProgressCount) const WdCopyFileProgressInfo* fileUpdates,
    _In_ const WdCopyOperationSummary* copyUpdates,
    _In_opt_ void* context
);
```

### 매개 변수

`fileProgressCount _In_`\
형식: **size\_t**

마지막 콜백 호출 이후 진행률 업데이트가 있는 파일의 수입니다.

`fileUpdates _In_reads_opt_(fileProgressCount)`\
형식: **const [WdCopyFileProgressInfo](/reference/remoting/structs/wdcopyfileprogressinfo)\***

각 항목이 개별 파일의 진행 정보를 포함하는 [WdCopyFileProgressInfo](/reference/remoting/structs/wdcopyfileprogressinfo) 구조체 배열에 대한 포인터입니다. `fileProgressCount`가 0이면 `nullptr`일 수 있습니다.

`copyUpdates _In_`\
형식: **const [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary)\***

전체 복사 작업 진행 상황 요약이 포함된 [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary) 구조체에 대한 포인터입니다.

`context _In_opt_`
형식: **void\***

[WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks) 구조체에 지정된 사용자 정의 컨텍스트 포인터입니다.

### 반환 값

형식: **HRESULT**

복사 작업을 계속하려면 `S_OK`를 반환합니다. 복사를 중단하려면 실패 HRESULT를 반환합니다.

## 설명

이 콜백은 복사 작업 중 개별 파일의 진행률을 보고하기 위해 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)에 의해 호출됩니다. 호출 빈도는 [WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks)의 `refreshRateMs` 멤버에 의해 제어됩니다.

이 콜백에서 실패한 HRESULT를 반환하면 복사 작업이 중단되고 `WdRemoteCopy`에서 해당 오류가 반환됩니다.

콜백은 `WdRemoteCopy` 호출과 동일한 스레드에서 호출됩니다. `fileUpdates` 배열, `copyUpdates` 구조체 및 그 내용은 콜백 호출 기간 동안에만 유효합니다.

## 요구 사항

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

## 함께 보기

* [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)
* [WdCopyFileProgressInfo](/reference/remoting/structs/wdcopyfileprogressinfo)
* [WdCopyOperationSummary](/reference/remoting/structs/wdcopyoperationsummary)
* [WdCopyStatusCallbacks](/reference/remoting/structs/wdcopystatuscallbacks)
* [XBOX PC Remote Iteration API](/reference/remoting/remoteiteration_members)


## Related topics

- [WdCopyStatusCallbacks](/ko/reference/remoting/structs/wdcopystatuscallbacks.md)
- [WdCopyFileProgressInfo](/ko/reference/remoting/structs/wdcopyfileprogressinfo.md)
- [WdCopyOperationSummary](/ko/reference/remoting/structs/wdcopyoperationsummary.md)
- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)
- [WdCopyErrorCallback](/ko/reference/remoting/callbacks/wdcopyerrorcallback.md)