Skip to main content

​
XblAchievementsUpdateAchievementAsync

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 XBOX User ID du joueur. achievementId   _In_z_
Type : char* ID du succès, encodé en UTF-8, tel que défini par XDP ou le Centre de développement. percentComplete   _In_
Type : uint32_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 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 connexion sur PC et XBOX One. Les mises à jour effectuées hors connexion sont publiées par le système une fois la connexion 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é. Si le succès a déjà été déverrouillé ou si la valeur de progression est inférieure ou égale à celle actuellement enregistrée sur le serveur, XAsyncGetStatus() dans le rappel retourne HTTP_E_STATUS_NOT_MODIFIED (0x80190130L).

​
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