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

# XblAchievementsManagerGetAchievementsByState

> XblAchievementsManagerGetAchievementsByState

# XblAchievementsManagerGetAchievementsByState

获取玩家处于特定进度状态的成就列表。

## 语法

```cpp theme={null}
HRESULT XblAchievementsManagerGetAchievementsByState(  
         uint64_t xboxUserId,  
         XblAchievementOrderBy sortField,  
         XblAchievementsManagerSortOrder sortOrder,  
         XblAchievementProgressState achievementState,  
         XblAchievementsManagerResultHandle* achievementsResult  
)  
```

### 参数

*xboxUserId*   \_In\_\
类型：uint64\_t

玩家的 XBOX 用户 ID。

*sortField*   \_In\_\
类型：[XblAchievementOrderBy](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby.md)

用于对成就列表进行排序的字段。TitleId 的行为与 DefaultOrder 相同，因为 AchievementsManager 一次只处理一个标题。

*sortOrder*   \_In\_\
类型：[XblAchievementsManagerSortOrder](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder.md)

对成就列表进行排序的方向。

*achievementState*   \_In\_\
类型：[XblAchievementProgressState](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate.md)

要包含在结果中的成就状态。

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

AchievementsManager API 调用结果的句柄。其他 API 使用此句柄获取与所调用 API 相匹配的成就对象。当不再需要该结果时，必须使用 [XblAchievementsManagerResultCloseHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle.md) 关闭句柄。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 要求

**头文件：** 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

- [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)
- [XblAchievementsManagerGetAchievement](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerUpdateAchievement](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)