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

# PFGameSaveFilesGetFolder

> 返回此用户的游戏存档文件和文件夹的根文件夹。其中的所有文件和子文件夹都将与云同步。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。

返回此用户的游戏存档文件和文件夹的根文件夹。其中的所有文件和子文件夹都将与云同步。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。

## 语法

```cpp theme={null}
HRESULT PFGameSaveFilesGetFolder(  
    PFLocalUserHandle localUserHandle,  
    size_t saveRootFolderSize,  
    char* saveRootFolderBuffer,  
    size_t* saveRootFolderUsed  
)  
```

### 参数

**`localUserHandle`**   PFLocalUserHandle

要返回其游戏存档文件夹的本地用户。

**`saveRootFolderSize`**   size\_t

游戏存档文件和文件夹的根文件夹的大小（以字节为单位）。

**`saveRootFolderBuffer`**   char\*<br />**Out\_writes*(saveRootFolderSize)*

用于接收游戏存档文件和文件夹的根文件夹的缓冲区。

**`saveRootFolderUsed`**   size\_t\*<br />*optional output*

所提供缓冲区中已使用的字节数。

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 要求

**头文件：** PFGameSaveFiles.h

## 另请参阅

[PFGameSaveFiles 成员](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [Game Saves 离线模式](/zh-CN/services/playfab/player-progression/game-saves/offline.md)
- [PFGameSaveFilesUploadWithUiAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiasync.md)
- [PFGameSaveFilesAddUserWithUiAsync](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiasync.md)
- [服务 C API 概览 - PFGameSaveFiles.h](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)
- [PFGameSaveFilesGetFolderSize](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfoldersize.md)