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

# WdCopyStatusCallbacks

> WdCopyStatusCallbacks

# WdCopyStatusCallbacks

복사 상태 업데이트를 수신하기 위한 콜백 함수 포인터와 설정을 포함합니다.

## 구문

```cpp theme={null}
struct WdCopyStatusCallbacks
{
    WdCopyFilesStatusCallback copyFilesStatusCallback;
    uint32_t refreshRateMs;
    WdCopyErrorCallback copyErrorCallback;
    void* context;
};
```

### 멤버

`copyFilesStatusCallback`\
형식: **[WdCopyFilesStatusCallback](/reference/remoting/callbacks/wdcopyfilesstatuscallback)**

파일 복사 진행 상황을 보고하기 위해 호출되는 콜백 함수입니다. 파일 진행 업데이트가 필요하지 않은 경우 `nullptr`로 설정합니다.

`refreshRateMs`\
형식: **uint32\_t**

`copyFilesStatusCallback`에 대한 콜백 호출 사이의 최소 간격(밀리초)입니다. 지정되지 않았거나 `0`으로 설정된 경우 기본 새로 고침 속도는 500ms입니다.

`copyErrorCallback`\
형식: **[WdCopyErrorCallback](/reference/remoting/callbacks/wdcopyerrorcallback)**

오류나 경고 같은 복사 작업의 진단 메시지를 수신하는 선택적 콜백 함수입니다. 진단 메시지가 필요하지 않은 경우 `nullptr`로 설정합니다.

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

두 콜백 함수 모두에 전달되는 선택적 사용자 정의 컨텍스트 포인터입니다. 컨텍스트가 필요하지 않은 경우 `nullptr`로 설정합니다.

## 설명

이 구조체를 [WdRemoteCopy](/reference/remoting/functions/wdremotecopy)의 `statusCallbacks` 매개 변수로 전달하여 복사 작업 도중 진행 업데이트와 진단 메시지를 수신합니다. `refreshRateMs` 멤버는 `copyFilesStatusCallback`이 호출되는 빈도를 제어합니다. 지정되지 않았거나 `0`으로 설정된 경우 기본 새로 고침 속도는 500ms입니다. `context` 포인터는 변경 없이 두 콜백에 전달되므로 애플리케이션별 상태와 콜백을 연결할 수 있습니다.

## 요구 사항

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

## 함께 보기

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


## Related topics

- [WdCopyFilesStatusCallback](/ko/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
- [WdCopyErrorCallback](/ko/reference/remoting/callbacks/wdcopyerrorcallback.md)
- [WdCopyErrorSeverity](/ko/reference/remoting/enums/wdcopyerrorseverity.md)
- [WdRemoteCopy](/ko/reference/remoting/functions/wdremotecopy.md)
- [XBOX PC Remote Iteration API](/ko/reference/remoting/remoteiteration_members.md)