Passer au contenu principal

​
XblAchievementsManagerUpdateAchievement

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

​
Syntaxe

​
Paramètres

xboxUserId   _In_
Type : uint64_t ID utilisateur XBOX du joueur. achievementId   _In_
Type : char* ID du succès encodé en UTF-8, tel que défini par le Dev Center. currentProgess   _In_
Type : uint8_t Pourcentage d’achèvement du succès indiquant la progression. Les valeurs valides vont de 1 à 100. Définissez la valeur sur 100 pour déverrouiller le succès. Le serveur définit la progression sur la valeur la plus élevée envoyée.

​
Valeur de retour

Type : HRESULT Code de retour HRESULT de cette opération d’API.

​
Remarques

À condition que l’Achievements Manager ait été initialisé avec succès à l’aide de XblAchievementsManagerAddLocalUser, cette API fonctionne même hors connexion sur PC et sur consoles XBOX. Les mises à jour hors connexion 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 est 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 contient un XblAchievementsManagerEvent dont le type d’événement est AchievementProgressUpdated, et éventuellement 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 des événements ne peuvent pas être mis à jour avec cette fonction.

​
Appel REST

V2 POST /users/xuid()/achievements//update

​
Configuration requise

En-tête : achievements_manager_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

​
Voir aussi

achievements_manager_c
Dernière modification le 6 octobre 2026