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

> 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](/es/services/playfab/api-references/c/pfgamesavefilestypes/enums/pfgamesavefilesadduseroptions)

Opciones que se usarán al agregar el usuario.

**`async`**   XAsyncBlock\*<br />*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](/es/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

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