> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblAchievementsManagerResultGetAchievements

> XblAchievementsManagerResultGetAchievements

# XblAchievementsManagerResultGetAchievements

获取 XblAchievement 对象的列表。

## 语法

```cpp theme={null}
HRESULT XblAchievementsManagerResultGetAchievements(  
         XblAchievementsManagerResultHandle resultHandle,  
         const XblAchievement** achievements,  
         uint64_t* achievementsCount  
)  
```

### 参数

*resultHandle*   \_In\_\
类型：[XblAchievementsManagerResultHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle.md)

成就结果句柄。

*achievements*   \_Out\_\
类型：[XblAchievement\*\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_c/structs/xblachievement.md)

指向 XblAchievement 对象数组的指针。所返回指针的内存在 XblAchievementsManagerResultHandle 对象的生命周期内一直有效，直至其被关闭。

*achievementsCount*   \_Out\_\
类型：uint64\_t\*

返回数组中对象的数量。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

当使用 [XblAchievementsManagerResultCloseHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle.md) 关闭了对该对象的所有未关闭句柄后，所返回的 XblAchievement 对象数组将被释放。但数据可能会变得陈旧。

## 要求

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

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[achievements\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)


## Related topics

- [XblAchievementsManagerResultHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle.md)
- [achievements_manager_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)
- [XBOX 成就管理器 API 概述](https://docs.xbox.com/zh-CN/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievements](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerGetAchievement](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)