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

# XGameSaveFilesGetFolderWithUiAsync

> XGameSaveFilesGetFolderWithUiAsync

# XGameSaveFilesGetFolderWithUiAsync

傳回可用來容納目錄和檔案以供儲存的資料夾。

## 語法

```cpp theme={null}
HRESULT XGameSaveFilesGetFolderWithUiAsync(
  XUserHandle requestingUser,
  const char * configurationId,
  XAsyncBlock * async
)
```

### 參數

`requestingUser`\
類型：*In* XUserHandle

XBOX Live 使用者的控制代碼。

`configurationId`\
類型：*In\_z* const char \*

服務設定識別碼 (SCID)。

`async`\
類型：*In* XAsyncBlock \*

包含非同步呼叫的資訊。

### 傳回值

類型：HRESULT

函式結果。

### 備註

遊戲不能混用 XGameSaveFiles 與 XGameSave。遊戲必須選擇想要使用的雲端存檔系統。
如果遊戲使用 XGameSaveFiles，之後又呼叫 XGameSaveInitializeProvider，將會發生錯誤
E\_GS\_PROVIDER\_MISMATCH。同樣地，如果遊戲使用 XGameSave，之後又呼叫 XGameSaveFilesGetFolderWithUiAsync，
也會發生錯誤 E\_GS\_PROVIDER\_MISMATCH。

當遊戲繼續執行時，開發人員應呼叫 **XGameSaveFilesGetFolderWithUiAsync**，以確保存檔資料
完全是最新狀態。

## 需求

**標頭：** XGameSaveFiles.h

## 概念文件

* [偵錯遊戲存檔](/zh-TW/build/core-features/common/game-save/game-saves-debugging)
* [遊戲存檔工具](/zh-TW/build/core-features/common/game-save/game-saves-tools)
* [遊戲存檔逐步解說和範例](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples)
* [在您的遊戲中實作雲端存檔](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-services/e2e-cloud-saves)

## 另請參閱

[XGameSaveFiles 成員](/zh-TW/reference/system/xgamesavefiles/xgamesavefiles_members)\
[XGameSaveFiles 概觀](/zh-TW/build/core-features/common/game-save/xgamesavefiles)


## Related topics

- [XGameSaveFilesGetFolderWithUiAsync](/ja-jp/reference/system/xgamesavefiles/functions/xgamesavefilesgetfolderwithuiasync.md)
- [XGameSaveFiles](/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [Game Saves walkthroughs and samples](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [Game Saves debugging](/build/core-features/common/game-save/game-saves-debugging.md)