Skip to main content

​
XblAchievementsUpdateAchievementForTitleIdAsync

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

​
Syntaxe

​
Paramètres

xboxLiveContext   _In_
Type : XblContextHandle Handle de contexte XBOX Live créé avec XblContextCreateHandle. xboxUserId   _In_
Type : uint64_t Identifiant d’utilisateur XBOX du joueur. titleId   _In_
Type : uint32_t Identifiant du titre. serviceConfigurationId   _In_z_
Type : char* Identifiant de configuration de service (SCID) du titre. Le SCID respecte la casse; collez-le donc directement à partir de Partner Center. achievementId   _In_z_
Type : char* Identifiant unique, encodé en UTF-8, du succès tel que défini par XDP ou Dev Center. percentComplete   _In_
Type : uint32_t Pourcentage d’achèvement du succès pour indiquer la progression. Les valeurs valides vont de 1 à 100. Définissez la valeur à 100 pour déverrouiller le succès. Le serveur définira la progression à la valeur la plus élevée envoyée. async   _In_
Type : XAsyncBlock* AsyncBlock alloué par l’appelant.

​
Valeur de retour

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

​
Remarques

Cette API fonctionne même hors ligne sur PC et XBOX One. Les mises à jour hors ligne seront publiées par le système lorsque la connexion sera rétablie, même si le titre n’est pas en cours d’exécution. Le résultat de l’opération asynchrone peut être obtenu en appelant XAsyncGetStatus dans le rappel AsyncBlock ou une fois l’AsyncBlock terminé. En cas d’échec inattendu, assurez-vous que le SCID est correctement indiqué dans XblInitArgs, car il respecte la casse.

​
Appel REST

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

​
Configuration requise

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

​
Voir aussi

achievements_c
Last modified on October 6, 2026