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

# PFGameSaveFilesAddUserWithUiAsync

> Adiciona um usuário ao sistema de jogos salvos. Isso baixa o estado salvo da nuvem conforme necessário e pode disparar estes retornos de chamada de interface do usuário: PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback Confira PFGameSaveFilesSetUiCallbacks para obter mais detalhes. PFGameSaveFilesInitialize deve ser chamado antes. Nas plataformas XBOX e Windows, a interface do usuário padrão é fornecida pelo sistema.

Adiciona um usuário ao sistema de jogos salvos. Isso baixa o estado salvo da nuvem conforme necessário e pode disparar estes retornos de chamada de interface do usuário: PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback Confira PFGameSaveFilesSetUiCallbacks para obter mais detalhes. PFGameSaveFilesInitialize deve ser chamado antes. Nas plataformas XBOX e Windows, a interface do usuário padrão é fornecida pelo sistema.

## Sintaxe

```cpp theme={null}
HRESULT PFGameSaveFilesAddUserWithUiAsync(  
    PFLocalUserHandle localUserHandle,  
    PFGameSaveFilesAddUserOptions options,  
    XAsyncBlock* async  
)  
```

### Parâmetros

**`localUserHandle`**   PFLocalUserHandle

Usuário local a ser adicionado.

**`options`**   [PFGameSaveFilesAddUserOptions](/pt-BR/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions)

Opções a serem usadas ao adicionar o usuário.

**`async`**   XAsyncBlock\*<br />*Inout*

Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

### Valor de retorno

Tipo: HRESULT

Para recuperar o resultado de uma chamada para PFGameSaveFilesAddUserWithUiAsync, chame PFGameSaveFilesAddUserWithUiResult. Após a conclusão dessa chamada, você pode chamar PFGameSaveFilesGetFolder para obter a pasta raiz dos arquivos e pastas de jogos salvos deste usuário. Todos os arquivos e subpastas da pasta raiz serão sincronizados com a nuvem. Isso só pode ser chamado uma vez por usuário, normalmente antes de mostrar o menu principal do jogo. Para disparar novamente o download do mesmo usuário, chame PFGameSaveFilesUninitializeAsync e aguarde a conclusão primeiro

## Requisitos

**Cabeçalho:** PFGameSaveFiles.h

## Confira também

[Membros de PFGameSaveFiles](/pt-BR/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](/pt-BR/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/pt-BR/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [PFGameSaveFilesSetUiCallbacks](/pt-BR/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](/pt-BR/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)
- [Retornos de chamada de interface do Game Saves](/pt-BR/services/playfab/player-progression/game-saves/ui-callbacks.md)