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

Representa uma notificação de desbloqueio de conquista recebida do serviço de notificação.

## Sintaxe

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

### Membros

*achievementName*\
Tipo: const char\*

O nome da conquista na localidade do DeviceEndpoint para o qual está sendo enviada (limite atual de caracteres: 44).

*achievementDescription*\
Tipo: const char\*

A descrição da conquista na localidade do DeviceEndpoint para o qual está sendo enviada.

*achievementIcon*\
Tipo: const char\*

A URL da imagem associada à conquista (comprimento máximo: 2048).

*achievementId*\
Tipo: const char\*

A ID na base 10 do título para o qual a conquista está definida.

*gamerscore*\
Tipo: uint64\_t

A quantidade de gamerscore obtida ao desbloquear a conquista (pode ser 0; desafios não podem ter gamerscore).

*titleId*\
Tipo: uint32\_t

A ID na base 10 do título para o qual a conquista está definida.

*xboxUserId*\
Tipo: uint64\_t

O identificador de usuário do XBOX da pessoa.

*deepLink*\
Tipo: const char\*

O link profundo definido na conquista.

*rarityPercentage*\
Tipo: float

A razão entre a contagem de usuários que desbloquearam a conquista e o número total de usuários exclusivos desse título, expressa como um valor fracionário >= 0.0 e \<= 1.0, arredondado para 2 casas decimais.

*rarityCategory*\
Tipo: [XblAchievementRarityCategory](/pt-BR/reference/live/xsapi-c/achievements_c/enums/xblachievementraritycategory)

"Rare" ou "Common", em que conquistas Rare são aquelas com rarityPercentage \<= 9% (ou 0.9) e "Common" é todo o resto. (Esta cadeia de caracteres não é localizada).

*timeUnlocked*\
Tipo: time\_t

O carimbo de data/hora em que a conquista foi desbloqueada pela primeira vez para este usuário.

## Requisitos

**Cabeçalho:** achievements\_c.h

## Confira também

[achievements\_c](/pt-BR/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)