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

# WdCopyStatusCallbacks

> WdCopyStatusCallbacks

# WdCopyStatusCallbacks

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

## 구문

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

### 멤버

`copyFilesStatusCallback`\
형식: **[WdCopyFilesStatusCallback](https://docs.xbox.com/ko/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)**

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

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

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

`copyErrorCallback`\
형식: **[WdCopyErrorCallback](https://docs.xbox.com/ko/reference/remoting/callbacks/wdcopyerrorcallback.md)**

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

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

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

## 설명

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

## 요구 사항

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

## 함께 보기

* [WdRemoteCopy](https://docs.xbox.com/ko/reference/remoting/functions/wdremotecopy.md)
* [WdCopyFilesStatusCallback](https://docs.xbox.com/ko/reference/remoting/callbacks/wdcopyfilesstatuscallback.md)
* [WdCopyErrorCallback](https://docs.xbox.com/ko/reference/remoting/callbacks/wdcopyerrorcallback.md)
* [XBOX PC Remote Iteration API](https://docs.xbox.com/ko/reference/remoting/remoteiteration_members.md)


## Related topics

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