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

# PFGameSaveFilesUiProgressGetProgress

> 동기화 작업의 현재 진행률을 가져옵니다. 최신 바이트 수준 진행률을 확인하려면 PFGameSaveFilesUiProgressCallback 내에서 이 함수를 호출하거나 동기화가 진행되는 동안 주기적으로 폴링하세요. PreparingForUpload 중에는 current/total이 처리된/예상되는 비압축 바이트 수를 나타냅니다. Uploading 중에는 current/total이 전송된/예상되는 비압축 바이트 수를 나타냅니다. Downloading 중에는 current/total이 다운로드된/예상되는 바이트 수를 나타냅니다. total이 0이면 전체 크기를 아직 알 수 없으므로, 타이틀은 0으로 나누거나 0%를 표시하는 대신 이를 불확정 진행률로 처리해야 합니다(예: 스피너 표시).

동기화 작업의 현재 진행률을 가져옵니다. 최신 바이트 수준 진행률을 확인하려면 PFGameSaveFilesUiProgressCallback 내에서 이 함수를 호출하거나 동기화가 진행되는 동안 주기적으로 폴링하세요. PreparingForUpload 중에는 current/total이 처리된/예상되는 비압축 바이트 수를 나타냅니다. Uploading 중에는 current/total이 전송된/예상되는 비압축 바이트 수를 나타냅니다. Downloading 중에는 current/total이 다운로드된/예상되는 바이트 수를 나타냅니다. total이 0이면 전체 크기를 아직 알 수 없으므로, 타이틀은 0으로 나누거나 0%를 표시하는 대신 이를 불확정 진행률로 처리해야 합니다(예: 스피너 표시).

## 구문

```cpp theme={null}
HRESULT PFGameSaveFilesUiProgressGetProgress(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesSyncState* syncState,  
    uint64_t* current,  
    uint64_t* total  
)  
```

### 매개 변수

**`localUserHandle`**   PFLocalUserHandle

로컬 사용자 핸들입니다.

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

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

**`current`**   uint64\_t\*\
*optional output*

활성 상태에서 현재까지 처리된 바이트 수입니다.

**`total`**   uint64\_t\*\
*optional output*

활성 상태에서 예상되는 전체 바이트 수입니다.

### 반환 값

형식: HRESULT

TBD

## 요구 사항

**헤더:** PFGameSaveFilesUi.h

## 참고 항목

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


## Related topics

- [PFGameSaveFilesUiProgressCallback](/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md)
- [Game Saves UI 콜백](/ko/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [Services C API 개요 - PFGameSaveFilesUi.h](/ko/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveFilesUiProgressUserAction](/ko/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)
- [PFGameSaveFilesSetUiProgressResponse](/ko/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md)