> ## 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%。

取得同步作業的目前進度。請從 PFGameSaveFilesUiProgressCallback 內呼叫此函式，或在同步進行期間定期輪詢，以取得最新的位元組層級進度。在 PreparingForUpload 期間，current/total 反映已處理/預期的未壓縮位元組數。在 Uploading 期間，current/total 反映已傳輸/預期的未壓縮位元組數。在 Downloading 期間，current/total 反映已下載/預期的位元組數。如果 total 為 0，表示總大小尚未得知，遊戲應將此視為不確定進度 (例如，顯示旋轉圖示)，而不是除以零或顯示 0%。

## 語法

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

### 參數

**`localUserHandle`**   PFLocalUserHandle

本機使用者控制代碼。

**`syncState`**   [PFGameSaveFilesSyncState\*](/zh-TW/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 成員](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members)


## Related topics

- [PFGameSaveFilesUiProgressCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md)
- [Game Saves UI 回呼](/zh-TW/services/playfab/player-progression/game-saves/ui-callbacks.md)
- [服務 C API 概觀 - PFGameSaveFilesUi.h](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PlayFab Services C/C++ SDK 版本資訊](/zh-TW/services/playfab/release-notes/playfab-c/index.md)
- [PFGameSaveFilesUiProgressUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)