> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGameSaveFilesAddUserWithUiAsync

> Agrega un usuario al sistema de partidas guardadas. Descarga el estado guardado desde la nube según sea necesario y podría desencadenar estos callbacks de la interfaz de usuario: PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback Consulte PFGameSaveFilesSetUiCallbacks para obtener más detalles. Se debe llamar previamente a PFGameSaveFilesInitialize. En las plataformas XBOX y Windows, el sistema proporciona la interfaz de usuario estándar.

Agrega un usuario al sistema de partidas guardadas. Descarga el estado guardado desde la nube según sea necesario y podría desencadenar estos callbacks de la interfaz de usuario: PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback Consulte PFGameSaveFilesSetUiCallbacks para obtener más detalles. Se debe llamar previamente a PFGameSaveFilesInitialize. En las plataformas XBOX y Windows, el sistema proporciona la interfaz de usuario estándar.

## Sintaxis

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

### Parámetros

**`localUserHandle`**   PFLocalUserHandle

Usuario local que se va a agregar.

**`options`**   [PFGameSaveFilesAddUserOptions](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions.md)

Opciones que se usarán al agregar el usuario.

**`async`**   XAsyncBlock\*\
*Inout*

Un XAsyncBlock para sondear el estado de la llamada y recuperar sus resultados.

### Valor devuelto

Tipo: HRESULT

Para recuperar el resultado de una llamada a PFGameSaveFilesAddUserWithUiAsync, llame a PFGameSaveFilesAddUserWithUiResult. Una vez completada esta llamada, puede llamar a PFGameSaveFilesGetFolder para obtener la carpeta raíz de los archivos y carpetas de partidas guardadas de este usuario. Todos los archivos y subcarpetas de la carpeta raíz se sincronizarán con la nube. Solo se puede llamar una vez por usuario, normalmente antes de mostrar el menú principal del juego. Para volver a desencadenar la descarga del mismo usuario, llame primero a PFGameSaveFilesUninitializeAsync y espere a que se complete

## Requisitos

**Encabezado:** PFGameSaveFiles.h

## Consulte también

[Miembros de PFGameSaveFiles](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [PFGameSaveFilesUiSyncFailedUserAction](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [PFGameSaveFilesSetUiCallbacks](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](https://docs.xbox.com/es/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)
- [Devoluciones de llamada de la interfaz de usuario de Game Saves](https://docs.xbox.com/es/services/playfab/player-progression/game-saves/ui-callbacks.md)