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

# XblAchievement

> XblAchievement

# XblAchievement

表示一项成就，即一种系统级机制，用于跨所有游戏一致地引导和奖励用户的游戏内行为。

## 语法

```cpp theme={null}
typedef struct XblAchievement {  
    const char* id;  
    const char* serviceConfigurationId;  
    const char* name;  
    XblAchievementTitleAssociation* titleAssociations;  
    size_t titleAssociationsCount;  
    XblAchievementProgressState progressState;  
    XblAchievementProgression progression;  
    XblAchievementMediaAsset* mediaAssets;  
    size_t mediaAssetsCount;  
    const char** platformsAvailableOn;  
    size_t platformsAvailableOnCount;  
    bool isSecret;  
    const char* unlockedDescription;  
    const char* lockedDescription;  
    const char* productId;  
    XblAchievementType type;  
    XblAchievementParticipationType participationType;  
    XblAchievementTimeWindow available;  
    XblAchievementReward* rewards;  
    size_t rewardsCount;  
    uint64_t estimatedUnlockTime;  
    const char* deepLink;  
    bool isRevoked;  
} XblAchievement  
```

### 成员

*id*\
类型：const char\*

UTF-8 编码的成就 ID。表示一个 uint。

*serviceConfigurationId*\
类型：const char\*

与该成就关联的服务配置 ID (SCID)。SCID 区分大小写，因此请直接从合作伙伴中心复制粘贴

*name*\
类型：const char\*

UTF-8 编码的本地化成就名称。

*titleAssociations*\
类型：[XblAchievementTitleAssociation\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementtitleassociation)

与该成就相关联的游戏/应用标题。

*titleAssociationsCount*\
类型：size\_t

**titleAssociations** 的大小。

*progressState*\
类型：[XblAchievementProgressState](/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

用户获得该成就的进度状态。

*progression*\
类型：[XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression)

包含成就进度详情（包括要求）的进度对象。

*mediaAssets*\
类型：[XblAchievementMediaAsset\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

与该成就关联的媒体资源，例如图像 ID。

*mediaAssetsCount*\
类型：size\_t

**mediaAssets** 的大小。

*platformsAvailableOn*\
类型：const char\*\*

该成就可用的平台的 UTF-8 编码集合。

*platformsAvailableOnCount*\
类型：size\_t

**platformsAvailableOn** 的大小。

*isSecret*\
类型：bool

该成就是否为秘密成就。

*unlockedDescription*\
类型：const char\*

已解锁成就的 UTF-8 编码描述。

*lockedDescription*\
类型：const char\*

锁定状态成就的 UTF-8 编码描述。

*productId*\
类型：const char\*

发布该成就时使用的 UTF-8 编码的 product\_id。这是一个全球唯一标识符，可能对应于一个应用程序、可下载内容等。

*type*\
类型：[XblAchievementType](/reference/live/xsapi-c/achievements_c/enums/xblachievementtype)

成就类型，例如挑战成就。

*participationType*\
类型：[XblAchievementParticipationType](/reference/live/xsapi-c/achievements_c/enums/xblachievementparticipationtype)

该成就的参与类型，例如群组或个人。

*available*\
类型：[XblAchievementTimeWindow](/reference/live/xsapi-c/achievements_c/structs/xblachievementtimewindow)

该成就可用的时间窗口。适用于挑战成就。

*rewards*\
类型：[XblAchievementReward\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementreward)

成就解锁时玩家获得的奖励集合。

*rewardsCount*\
类型：size\_t

**rewards** 的大小。

*estimatedUnlockTime*\
类型：uint64\_t

获得该成就所需的预计时间。

*deepLink*\
类型：const char\*

面向客户端的 UTF-8 编码深层链接，可使标题在与该成就相关的所需起点启动。

*isRevoked*\
类型：bool

指示该成就是否已被执法系统撤销的值。

## 参数归属

[XblAchievementsResultGetAchievements](/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements)

## 要求

**头文件：** achievements\_c.h

## 另请参阅

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


## Related topics

- [XblAchievementsResultGetAchievements](/zh-CN/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)
- [XblAchievementType](/zh-CN/reference/live/xsapi-c/achievements_c/enums/xblachievementtype.md)
- [XblAchievementProgression](/zh-CN/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression.md)
- [XblAchievementReward](/zh-CN/reference/live/xsapi-c/achievements_c/structs/xblachievementreward.md)
- [XblAchievementsManagerResultGetAchievements](/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)