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

Returns a folder that can be used to contain directories and files for storage.

## Syntax

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

### Parameters

`requestingUser`\
Type: *In* XUserHandle

Handle to an XBOX Live user.

`configurationId`\
Type: *In\_z* const char \*

Service configuration ID (SCID).

`async`\
Type: *In* XAsyncBlock \*

Contains the information for the Async call.

### Return value

Type: HRESULT

Function result.

### Remarks

Games cannot mix the usage of XGameSaveFiles with the usage of XGameSave. Games much choose which cloud save system
they want to use. If the game is using XGameSaveFiles and later calls XGameSaveInitializeProvider, it will error out
with E\_GS\_PROVIDER\_MISMATCH. Equally, if the game was using XGameSave and later calls XGameSaveFilesGetFolderWithUiAsync,
that will also error out with E\_GS\_PROVIDER\_MISMATCH.

When a game is resumed, developers should call **XGameSaveFilesGetFolderWithUiAsync** in order to ensure that save data
is completely up-to-date.

## Requirements

**Header:** XGameSaveFiles.h

## Conceptual documentation

* [Debugging Game Saves](/build/core-features/common/game-save/game-saves-debugging)
* [Game Saves tools](/build/core-features/common/game-save/game-saves-tools)
* [Game Saves walkthroughs and samples](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples)
* [Implement cloud saves in your game](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-services/e2e-cloud-saves)

## See also

[XGameSaveFiles members](/reference/system/xgamesavefiles/xgamesavefiles_members)\
[XGameSaveFiles Overview](/build/core-features/common/game-save/xgamesavefiles)


## Related topics

- [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)
- [Game Saves tools](/build/core-features/common/game-save/game-saves-tools.md)
- [XGameSaveFiles API overview](/build/core-features/common/game-save/xgamesavefiles.md)