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

# PFGameSaveFilesUiProgressCallback

> 동기화 작업이 새 상태로 전환될 때 발생하는 알림 콜백입니다. 이 콜백은 상태 전환마다 한 번씩 발생하며(예: PreparingForUpload에 대해 한 번, Uploading에 대해 한 번), 상태 내에서 진행률이 증가할 때 반복적으로 발생하지 않습니다. 상태 내의 세부 진행률을 확인하려면 PFGameSaveFilesUiProgressGetProgress를 호출하여 현재 바이트 수와 전체 바이트 수를 폴링하세요. 타이틀은 이 콜백이 높은 빈도로 발생할 것으로 예상하지 말고 상태 변경 알림(예: 진행률 대화 상자 표시 또는 업데이트)으로 처리해야 합니다.

동기화 작업이 새 상태로 전환될 때 발생하는 알림 콜백입니다. 이 콜백은 상태 전환마다 한 번씩 발생하며(예: PreparingForUpload에 대해 한 번, Uploading에 대해 한 번), 상태 내에서 진행률이 증가할 때 반복적으로 발생하지 않습니다. 상태 내의 세부 진행률을 확인하려면 PFGameSaveFilesUiProgressGetProgress를 호출하여 현재 바이트 수와 전체 바이트 수를 폴링하세요. 타이틀은 이 콜백이 높은 빈도로 발생할 것으로 예상하지 말고 상태 변경 알림(예: 진행률 대화 상자 표시 또는 업데이트)으로 처리해야 합니다.

## 구문

```cpp theme={null}
void PFGameSaveFilesUiProgressCallback(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesSyncState syncState,  
    void* context  
)  
```

### 매개 변수

**`localUserHandle`**   PFLocalUserHandle

로컬 사용자 핸들입니다.

**`syncState`**   [PFGameSaveFilesSyncState](/ko/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilessyncstate)

작업의 새 동기화 상태입니다.

**`context`**   void\*<br />*optional*

콜백 등록 시 전달된 컨텍스트 포인터입니다.

### 반환 값

형식: void

TBD

## 요구 사항

**헤더:** PFGameSaveFilesUi.h

## 참고 항목

[PFGameSaveFilesUi 멤버](/ko/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members)


## Related topics

- [PFGameSaveFilesUiProgressUserAction](/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)
- [PFGameSaveFilesSetUiProgressResponse](/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md)
- [Services C API 개요 - PFGameSaveFilesUi.h](/ko/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveFilesUiProgressGetProgress](/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress.md)
- [PFGameSaveUICallbacks](/ko/services/playfab/api-references/c/pfgamesavefilesui/structs/pfgamesaveuicallbacks.md)