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

通知サービスから受信した実績アンロック通知を表します。

## 構文

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

### メンバー

*achievementName*\
型: const char\*

送信先の DeviceEndpoint のロケールにおける実績の名前 (現在の文字制限: 44)。

*achievementDescription*\
型: const char\*

送信先の DeviceEndpoint のロケールにおける実績の説明。

*achievementIcon*\
型: const char\*

実績に関連付けられたイメージへの URL (最大長: 2048)。

*achievementId*\
型: const char\*

実績が定義されているタイトルの 10 進数 ID。

*gamerscore*\
型: uint64\_t

実績のアンロックで獲得したゲーマースコアの量 (0 の場合もあります – チャレンジではゲーマースコアを持てません)。

*titleId*\
型: uint32\_t

実績が定義されているタイトルの 10 進数 ID。

*xboxUserId*\
型: uint64\_t

ユーザーの XBOX ユーザー識別子。

*deepLink*\
型: const char\*

実績に設定されたディープ リンク。

*rarityPercentage*\
型: float

実績をアンロックしたユーザー数 / そのタイトルの一意のユーザーの合計数の比率。小数点以下 2 桁に丸められた、>= 0.0 かつ \<= 1.0 の小数値として表されます。

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

"Rare" または "Common" – Rare 実績は rarityPercentage \<= 9% (0.9) の実績、"Common" はそれ以外のすべてです。(この文字列はローカライズされません。)

*timeUnlocked*\
型: time\_t

このユーザーに対して実績が最初にアンロックされたタイムスタンプ。

## 要件

**ヘッダー:** achievements\_c.h

## 関連項目

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