Skip to main content

XGameSaveFilesGetFolderWithUiAsync

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

Syntax

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

See also

XGameSaveFiles members
XGameSaveFiles Overview
Last modified on August 20, 2026