> ## 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](/zh-TW/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilessyncstate)

作業的新同步狀態。

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

在註冊回呼期間傳遞的內容指標。

### 傳回值

類型：void

TBD

## 需求

**標頭：** PFGameSaveFilesUi.h

## 另請參閱

[PFGameSaveFilesUi 成員](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members)


## Related topics

- [PFGameSaveFilesUiProgressUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)
- [PFGameSaveFilesSetUiProgressResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md)
- [服務 C API 概觀 - PFGameSaveFilesUi.h](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveUICallbacks](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/structs/pfgamesaveuicallbacks.md)
- [PFGameSaveFilesUiProgressGetProgress](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress.md)