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

알림 서비스에서 수신한 도전 과제 잠금 해제 알림을 나타냅니다.

## Syntax

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

### Members

*achievementName*\
Type: const char\*

전송 대상 DeviceEndpoint의 로캘로 표시된 도전 과제 이름입니다(현재 문자 제한: 44).

*achievementDescription*\
Type: const char\*

전송 대상 DeviceEndpoint의 로캘로 표시된 도전 과제 설명입니다.

*achievementIcon*\
Type: const char\*

도전 과제와 연결된 이미지의 URL입니다(최대 길이: 2048).

*achievementId*\
Type: const char\*

도전 과제가 정의된 타이틀의 10진수 ID입니다.

*gamerscore*\
Type: uint64\_t

도전 과제 잠금 해제로 획득한 gamerscore의 양입니다(0일 수 있음 - challenges는 gamerscore를 가질 수 없음).

*titleId*\
Type: uint32\_t

도전 과제가 정의된 타이틀의 10진수 ID입니다.

*xboxUserId*\
Type: uint64\_t

사용자의 XBOX 사용자 식별자입니다.

*deepLink*\
Type: const char\*

도전 과제에 설정된 딥 링크입니다.

*rarityPercentage*\
Type: float

해당 도전 과제를 잠금 해제한 사용자 수와 해당 타이틀의 전체 고유 사용자 수의 비율로, 0.0 이상 1.0 이하의 소수 값으로 표현되며 소수점 이하 2자리에서 반올림됩니다.

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

“Rare” 또는 “Common” - Rare 도전 과제는 rarityPercentage가 9%(또는 0.9) 이하인 것을 의미하고, “Common”은 그 밖의 모든 것을 의미합니다. (이 문자열은 지역화되지 않습니다.)

*timeUnlocked*\
Type: time\_t

이 사용자에 대해 도전 과제가 처음 잠금 해제된 시간의 타임스탬프입니다.

## Requirements

**Header:** achievements\_c.h

## See also

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


## Related topics

- [XblAchievementUnlockHandler](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockhandler.md)
- [XblAchievementUnlockRemoveNotificationHandler](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockremovenotificationhandler.md)
- [XblAchievementUnlockAddNotificationHandler](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockaddnotificationhandler.md)
- [XblAchievementsManagerEvent](/ko/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent.md)
- [XblAchievementsManagerEventType](/ko/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagereventtype.md)