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

Retorna uma pasta que pode ser usada para conter diretórios e arquivos para armazenamento.

## Sintaxe

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

### Parâmetros

`requestingUser`\
Tipo: *In* XUserHandle

Identificador de um usuário do XBOX Live.

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

ID de configuração do serviço (SCID).

`async`\
Tipo: *In* XAsyncBlock \*

Contém as informações da chamada assíncrona.

### Valor retornado

Tipo: HRESULT

Resultado da função.

### Comentários

Os jogos não podem misturar o uso de XGameSaveFiles com o uso de XGameSave. Os jogos devem escolher qual sistema de salvamento em nuvem
desejam usar. Se o jogo estiver usando XGameSaveFiles e depois chamar XGameSaveInitializeProvider, ocorrerá um erro
E\_GS\_PROVIDER\_MISMATCH. Da mesma forma, se o jogo estava usando XGameSave e depois chamar XGameSaveFilesGetFolderWithUiAsync,
também ocorrerá um erro E\_GS\_PROVIDER\_MISMATCH.

Quando um jogo for retomado, os desenvolvedores devem chamar **XGameSaveFilesGetFolderWithUiAsync** para garantir que os dados salvos
estejam totalmente atualizados.

## Requisitos

**Cabeçalho:** XGameSaveFiles.h

## Documentação conceitual

* [Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)
* [Ferramentas de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-tools)
* [Instruções passo a passo e exemplos de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-walkthroughs-and-samples)
* [Implementar salvamentos em nuvem no seu jogo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/tutorials/pc-e2e-guide/e2e-services/e2e-cloud-saves)

## Confira também

[Membros de XGameSaveFiles](/pt-BR/reference/system/xgamesavefiles/xgamesavefiles_members)\
[Visão geral de XGameSaveFiles](/pt-BR/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)