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

# XblAchievementReward

> XblAchievementReward

# XblAchievementReward

表示与成就关联的奖励。

## 语法

```cpp theme={null}
typedef struct XblAchievementReward {  
    const char* name;  
    const char* description;  
    const char* value;  
    XblAchievementRewardType rewardType;  
    const char* valueType;  
    XblAchievementMediaAsset* mediaAsset;  
} XblAchievementReward  
```

### 成员

*name*\
类型：const char\*

UTF-8 编码的本地化奖励名称。

*description*\
类型：const char\*

UTF-8 编码的奖励描述。

*value*\
类型：const char\*

UTF-8 编码的、由标题定义的奖励值（数据类型和内容因奖励类型而异）。

*rewardType*\
类型：[XblAchievementRewardType](/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype)

奖励类型。

*valueType*\
类型：const char\*

UTF-8 编码的奖励值字符串的属性类型。

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

与奖励关联的媒体资源。如果奖励类型为 gamerscore，此项将为 nullptr。如果奖励类型为 in\_app，此项将为媒体资源。如果奖励类型为 art，此项可能是媒体资源或 nullptr。

## 成员归属

[XblAchievement](/reference/live/xsapi-c/achievements_c/structs/xblachievement)

## 要求

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

## 另请参阅

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


## Related topics

- [XblAchievementRewardType](/zh-CN/reference/live/xsapi-c/achievements_c/enums/xblachievementrewardtype.md)
- [XblAchievementMediaAsset](/zh-CN/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset.md)
- [XblAchievement](/zh-CN/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)
- [XblAchievementsGetAchievementAsync](/zh-CN/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementasync.md)
- [XblAchievementsGetAchievementResult](/zh-CN/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementresult.md)