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

# XblAchievementsManagerAddLocalUser

> XblAchievementsManagerAddLocalUser

# XblAchievementsManagerAddLocalUser

Initialise le gestionnaire de succès (Achievements Manager) et génère un cache local des succès pour un utilisateur.

## Syntaxe

```cpp theme={null}
HRESULT XblAchievementsManagerAddLocalUser(  
         XblUserHandle user,  
         XTaskQueueHandle queue  
)  
```

### Paramètres

*user*   \_In\_\
Type : XblUserHandle

Utilisateur XBOX Live pour lequel récupérer les succès.

*queue*   \_In\_opt\_\
Type : XTaskQueueHandle

File d'attente à utiliser pour les opérations en arrière-plan de cet utilisateur (facultatif).

### Valeur de retour

Type : HRESULT

Code de retour HRESULT de cette opération d'API.

## Remarques

Comme `XblAchievementsManagerAddLocalUser` nécessite une connexion Internet pour suivre correctement les informations de l'utilisateur, cette fonction ne doit être appelée que lorsque l'appareil est connecté à Internet. L'utilisation de [XNetworkingRegisterConnectivityHintChanged](/fr-CA/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) est un bon moyen de vérifier la présence d'une connexion.

Si le gestionnaire de succès n'est pas initialisé, les appels à [XblAchievementsManagerUpdateAchievement](/fr-CA/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement) échoueront. Dans ce cas, il faut plutôt appeler [XblAchievementsUpdateAchievementAsync](/fr-CA/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync) à mesure que les conditions des succès sont remplies afin de garantir que la progression est tout de même suivie. Voici un exemple de mise en œuvre :

```cpp theme={null}
HRESULT hr = XblAchievementsManagerUpdateAchievement(xuid, "2", 3);
if (FAILED(hr))
{
    XAsyncBlock async{};
    hr = XblAchievementsUpdateAchievementAsync(m_xblContext, xuid, "2", 3, &async);
    if (SUCCEEDED(hr))
    {
        // this simple example is thread blocking. 
        // replace with whatever async pattern used by other XAsync calls in title
        XAsyncGetStatus(&async, true); 
    }
}
```

## Configuration requise

**En-tête :** achievements\_manager\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[achievements\_manager\_c](/fr-CA/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [Vue d'ensemble de l'API XBOX Achievements Manager](/fr-CA/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerUpdateAchievement](/fr-CA/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [XblAchievementsManagerRemoveLocalUser](/fr-CA/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerremovelocaluser.md)
- [XblSocialManagerAddLocalUser](/fr-CA/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/fr-CA/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)