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

# XblAchievementUnlockEvent

> XblAchievementUnlockEvent

# XblAchievementUnlockEvent

Représente une notification de déverrouillage de succès reçue du service de notification.

## Syntaxe

```cpp theme={null}
typedef struct XblAchievementUnlockEvent {  
    const char* achievementName;  
    const char* achievementDescription;  
    const char* achievementIcon;  
    const char* achievementId;  
    uint64_t gamerscore;  
    uint32_t titleId;  
    uint64_t xboxUserId;  
    const char* deepLink;  
    float rarityPercentage;  
    XblAchievementRarityCategory rarityCategory;  
    time_t timeUnlocked;  
} XblAchievementUnlockEvent  
```

### Membres

*achievementName*\
Type : const char\*

Nom du succès dans les paramètres régionaux du DeviceEndpoint auquel il est envoyé (limite actuelle de caractères : 44).

*achievementDescription*\
Type : const char\*

Description du succès dans les paramètres régionaux du DeviceEndpoint auquel il est envoyé.

*achievementIcon*\
Type : const char\*

URL de l'image associée au succès (longueur maximale : 2048).

*achievementId*\
Type : const char\*

Identifiant en base 10 du titre pour lequel le succès est défini.

*gamerscore*\
Type : uint64\_t

Nombre de points gamerscore obtenus pour le déverrouillage du succès (peut être 0 - les défis ne peuvent pas avoir de gamerscore).

*titleId*\
Type : uint32\_t

Identifiant en base 10 du titre pour lequel le succès est défini.

*xboxUserId*\
Type : uint64\_t

Identifiant d'utilisateur XBOX de la personne.

*deepLink*\
Type : const char\*

Lien profond défini sur le succès.

*rarityPercentage*\
Type : float

Rapport entre le nombre d'utilisateurs ayant déverrouillé le succès et le nombre total d'utilisateurs uniques de ce titre, exprimé sous forme de valeur fractionnaire >= 0.0 et \<= 1.0 arrondie à 2 décimales.

*rarityCategory*\
Type : [XblAchievementRarityCategory](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementraritycategory)

"Rare" ou "Common" - les succès Rare étant ceux dont le rarityPercentage est \<= 9 % (ou 0.9) et "Common" désignant tous les autres. (Cette chaîne n'est pas localisée.)

*timeUnlocked*\
Type : time\_t

Horodatage du premier déverrouillage du succès pour cet utilisateur.

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

- [XblAchievementUnlockEvent](/reference/live/xsapi-c/achievements_c/structs/xblachievementunlockevent.md)
- [XblAchievementUnlockHandler](/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockhandler.md)