Skip to main content

​
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 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, 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 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()/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
Last modified on October 6, 2026