> ## 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 una notificación de desbloqueo de logro recibida desde el servicio de notificaciones.

## Sintaxis

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

### Miembros

*achievementName*\
Tipo: const char\*

El nombre del logro en la configuración regional del DeviceEndpoint al que se envía (límite actual de caracteres: 44).

*achievementDescription*\
Tipo: const char\*

La descripción del logro en la configuración regional del DeviceEndpoint al que se envía.

*achievementIcon*\
Tipo: const char\*

La dirección URL de la imagen asociada al logro (longitud máxima: 2048).

*achievementId*\
Tipo: const char\*

El identificador en base 10 del título para el que se define el logro.

*gamerscore*\
Tipo: uint64\_t

La cantidad de gamerscore obtenida por desbloquear el logro (puede ser 0; los desafíos no pueden tener gamerscore).

*titleId*\
Tipo: uint32\_t

El identificador en base 10 del título para el que se define el logro.

*xboxUserId*\
Tipo: uint64\_t

El identificador de usuario de XBOX de la persona.

*deepLink*\
Tipo: const char\*

El vínculo profundo establecido en el logro.

*rarityPercentage*\
Tipo: float

La proporción entre el número de usuarios que han desbloqueado el logro y el número total de usuarios únicos de ese título, expresada como un valor fraccionario >= 0.0 y \<= 1.0 redondeado a 2 posiciones decimales.

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

"Rare" o "Common": los logros Rare son aquellos con un rarityPercentage \<= 9% (o 0.9) y "Common" es todo lo demás. (Esta cadena no está localizada).

*timeUnlocked*\
Tipo: time\_t

La marca de tiempo de cuando el logro se desbloqueó por primera vez para este usuario.

## Requisitos

**Encabezado:** achievements\_c.h

## Consulte también

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