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

# XblAchievementsManagerUpdateAchievement

> XblAchievementsManagerUpdateAchievement

# XblAchievementsManagerUpdateAchievement

Permet de mettre à jour la progression des succès et de déverrouiller des succès.

## Syntaxe

```cpp theme={null}
HRESULT XblAchievementsManagerUpdateAchievement(  
         uint64_t xboxUserId,  
         const char* achievementId,  
         uint8_t currentProgess  
)  
```

### Paramètres

*xboxUserId*   \_In\_\
Type : uint64\_t

L'ID d'utilisateur XBOX du joueur.

*achievementId*   \_In\_\
Type : char\*

L'ID de succès encodé en UTF-8, tel que défini par le Centre de développement.

*currentProgess*   \_In\_\
Type : uint8\_t

Le pourcentage d'achèvement du succès pour indiquer la progression. Les valeurs valides vont de 1 à 100. Définissez cette valeur à 100 pour déverrouiller le succès. Le serveur définit la progression à la valeur la plus élevée envoyée.

### Valeur de retour

Type : HRESULT

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

## Remarques

En supposant que le gestionnaire de succès a été initialisé avec succès à l'aide de [XblAchievementsManagerAddLocalUser](/fr-CA/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser), cette API fonctionne même hors ligne sur PC et sur les consoles XBOX. Les mises à jour hors ligne sont publiées par le système lorsque la connexion est rétablie, même si le titre n'est pas en cours d'exécution. Le résultat de l'opération n'est pas représenté localement immédiatement. La mise à jour sera reflétée au plus tôt après l'appel à DoWork de l'image suivante. Une fois la modification reflétée, le tableau renvoyé par DoWork contiendra un [XblAchievementsManagerEvent](/fr-CA/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent) avec le type d'événement AchievementProgressUpdated, et potentiellement un événement supplémentaire de type AchievementUnlocked si la nouvelle progression a entraîné le déverrouillage du succès. Si le succès a déjà été déverrouillé ou si la valeur de progression est inférieure ou égale à celle mise en cache à partir du serveur, cette fonction renvoie respectivement E\_NOT\_VALID\_STATE ou E\_INVALIDARG. Seuls les succès basés sur le titre peuvent être mis à jour avec cette fonction. Les succès basés sur les événements ne peuvent pas être mis à jour avec cette fonction.

## Appel REST

V2 POST /users/xuid({xuid})/achievements/{scid}/update

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

- [XblAchievementsManagerUpdateAchievement](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [Overview of the XBOX Achievements Manager API](/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XBOX Achievements Manager API 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerAddLocalUser](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanageraddlocaluser.md)
- [XBOX Achievements Manager API の概要](/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)