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

> Ajoute un utilisateur au système de sauvegarde de jeu. Cela télécharge l'état de sauvegarde depuis le nuage au besoin et peut déclencher les rappels d'interface utilisateur suivants : PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback. Consultez PFGameSaveFilesSetUiCallbacks pour plus de détails. PFGameSaveFilesInitialize doit être appelé au préalable. Sur les plateformes XBOX et Windows, une interface utilisateur standard est fournie par le système.

Ajoute un utilisateur au système de sauvegarde de jeu. Cela télécharge l'état de sauvegarde depuis le nuage au besoin et peut déclencher les rappels d'interface utilisateur suivants : PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback. Consultez PFGameSaveFilesSetUiCallbacks pour plus de détails. PFGameSaveFilesInitialize doit être appelé au préalable. Sur les plateformes XBOX et Windows, une interface utilisateur standard est fournie par le système.

## Syntaxe

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

### Paramètres

**`localUserHandle`**   PFLocalUserHandle

Utilisateur local à ajouter.

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

Options à utiliser lors de l'ajout de l'utilisateur.

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

Un XAsyncBlock permettant d'interroger l'état de l'appel et de récupérer les résultats de l'appel.

### Valeur de retour

Type : HRESULT

Pour récupérer le résultat d'un appel à PFGameSaveFilesAddUserWithUiAsync, appelez PFGameSaveFilesAddUserWithUiResult. Une fois cet appel terminé, vous pouvez appeler PFGameSaveFilesGetFolder pour obtenir le dossier racine des fichiers et dossiers de sauvegarde de jeu de cet utilisateur. Tous les fichiers et sous-dossiers du dossier racine seront synchronisés avec le nuage. Cette fonction ne peut être appelée qu'une seule fois par utilisateur, généralement avant d'afficher le menu principal du jeu. Pour déclencher de nouveau le téléchargement pour le même utilisateur, appelez PFGameSaveFilesUninitializeAsync et attendez d'abord qu'il se termine

## Configuration requise

**En-tête :** PFGameSaveFiles.h

## Voir aussi

[Membres de PFGameSaveFiles](/fr-CA/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members)


## Related topics

- [PFGameSaveFilesAddUserWithUiResult](/fr-CA/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult.md)
- [PFGameSaveFilesUiSyncFailedUserAction](/fr-CA/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction.md)
- [PFGameSaveFilesSetUiCallbacks](/fr-CA/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks.md)
- [PFGameSaveFilesIsConnectedToCloud](/fr-CA/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud.md)
- [Rappels d'interface utilisateur de Game Saves](/fr-CA/services/playfab/player-progression/game-saves/ui-callbacks.md)