> ## 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-CN/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilessyncstate)

操作的新同步状态。

**`context`**   void\*\
*可选*

注册回调时传递的上下文指针。

### 返回值

类型：void

TBD

## 要求

**头文件：** PFGameSaveFilesUi.h

## 另请参阅

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


## Related topics

- [PFGameSaveFilesUiProgressUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction.md)
- [PFGameSaveFilesSetUiProgressResponse](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md)
- [服务 C API 概览 - PFGameSaveFilesUi.h](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [PFGameSaveFilesUiProgressGetProgress](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress.md)
- [Game Saves UI 回调](/zh-CN/services/playfab/player-progression/game-saves/ui-callbacks.md)