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

# XblAchievement

> XblAchievement

# XblAchievement

Représente un succès, un mécanisme à l'échelle du système qui permet d'orienter et de récompenser les actions des utilisateurs en jeu de façon cohérente dans tous les jeux.

## Syntaxe

```cpp theme={null}
typedef struct XblAchievement {  
    const char* id;  
    const char* serviceConfigurationId;  
    const char* name;  
    XblAchievementTitleAssociation* titleAssociations;  
    size_t titleAssociationsCount;  
    XblAchievementProgressState progressState;  
    XblAchievementProgression progression;  
    XblAchievementMediaAsset* mediaAssets;  
    size_t mediaAssetsCount;  
    const char** platformsAvailableOn;  
    size_t platformsAvailableOnCount;  
    bool isSecret;  
    const char* unlockedDescription;  
    const char* lockedDescription;  
    const char* productId;  
    XblAchievementType type;  
    XblAchievementParticipationType participationType;  
    XblAchievementTimeWindow available;  
    XblAchievementReward* rewards;  
    size_t rewardsCount;  
    uint64_t estimatedUnlockTime;  
    const char* deepLink;  
    bool isRevoked;  
} XblAchievement  
```

### Membres

*id*\
Type : const char\*

Identifiant du succès, encodé en UTF-8. Représente un uint.

*serviceConfigurationId*\
Type : const char\*

Identifiant de configuration de service (SCID) associé au succès. Le SCID respecte la casse; collez-le donc directement à partir de Partner Center

*name*\
Type : const char\*

Nom localisé du succès, encodé en UTF-8.

*titleAssociations*\
Type : [XblAchievementTitleAssociation\*](/fr-CA/reference/live/xsapi-c/achievements_c/structs/xblachievementtitleassociation)

Titres de jeu ou d'application associés au succès.

*titleAssociationsCount*\
Type : size\_t

Taille de **titleAssociations**.

*progressState*\
Type : [XblAchievementProgressState](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

État de la progression d'un utilisateur vers l'obtention du succès.

*progression*\
Type : [XblAchievementProgression](/fr-CA/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression)

Objet de progression contenant les détails de la progression du succès, y compris les exigences.

*mediaAssets*\
Type : [XblAchievementMediaAsset\*](/fr-CA/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

Ressources multimédias associées au succès, comme les identifiants d'image.

*mediaAssetsCount*\
Type : size\_t

Taille de **mediaAssets**.

*platformsAvailableOn*\
Type : const char\*\*

Collection, encodée en UTF-8, des plateformes sur lesquelles le succès est offert.

*platformsAvailableOnCount*\
Type : size\_t

Taille de **platformsAvailableOn**.

*isSecret*\
Type : bool

Indique si le succès est secret ou non.

*unlockedDescription*\
Type : const char\*

Description du succès déverrouillé, encodée en UTF-8.

*lockedDescription*\
Type : const char\*

Description du succès verrouillé, encodée en UTF-8.

*productId*\
Type : const char\*

product\_id, encodé en UTF-8, avec lequel le succès a été publié. Il s'agit d'un identificateur global unique qui peut correspondre à une application, à du contenu téléchargeable, etc.

*type*\
Type : [XblAchievementType](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementtype)

Type de succès, comme un succès de défi.

*participationType*\
Type : [XblAchievementParticipationType](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementparticipationtype)

Type de participation pour le succès, comme en groupe ou individuel.

*available*\
Type : [XblAchievementTimeWindow](/fr-CA/reference/live/xsapi-c/achievements_c/structs/xblachievementtimewindow)

Période pendant laquelle le succès est offert. S'applique aux défis.

*rewards*\
Type : [XblAchievementReward\*](/fr-CA/reference/live/xsapi-c/achievements_c/structs/xblachievementreward)

Collection de récompenses que le joueur obtient lorsque le succès est déverrouillé.

*rewardsCount*\
Type : size\_t

Taille de **rewards**.

*estimatedUnlockTime*\
Type : uint64\_t

Temps estimé nécessaire pour obtenir le succès.

*deepLink*\
Type : const char\*

Lien profond, encodé en UTF-8, destiné aux clients, qui permet au titre de démarrer à un point de départ souhaité pour le succès.

*isRevoked*\
Type : bool

Valeur qui indique si le succès a été révoqué ou non par les mesures d'application.

## Argument de

[XblAchievementsResultGetAchievements](/fr-CA/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements)

## Configuration requise

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

## Voir aussi

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


## Related topics

- [XblAchievement](/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)
- [XblAchievementsResultGetAchievements](/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)
- [XblAchievementsManagerResultGetAchievements](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)
- [XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression.md)
- [XblAchievementReward](/reference/live/xsapi-c/achievements_c/structs/xblachievementreward.md)