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

# XblAchievementsUpdateAchievementAsync

> XblAchievementsUpdateAchievementAsync

# XblAchievementsUpdateAchievementAsync

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

## Syntaxe

```cpp theme={null}
HRESULT XblAchievementsUpdateAchievementAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         const char* achievementId,  
         uint32_t percentComplete,  
         XAsyncBlock* async  
)  
```

### Paramètres

*xboxLiveContext*   \_In\_\
Type : [XblContextHandle](/fr-CA/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Handle de contexte XBOX Live créé avec XblContextCreateHandle.

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

Identifiant d'utilisateur XBOX du joueur.

*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](/fr-CA/reference/system/xasync/functions/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 retournera HTTP\_E\_STATUS\_NOT\_MODIFIED (0x80190130L).

## Appel REST

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

## Configuration requise

**En-tête :** achievements\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[achievements\_c](/fr-CA/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [XblAchievementsUpdateAchievementAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [Updating title-managed Achievements](/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [Unity C# API wrappers for the GDK](/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [面向 GDK 的 Unity C# API 包装器](/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [Contenedores de API de C# de Unity para el GDK](/es/build/gdk-and-engines/unity/unity-api-wrappers.md)