> ## 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 使用者識別碼。

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

用來排序成就清單的欄位。TitleId 的行為會與 DefaultOrder 相同，因為 AchievementsManager 一次只處理一個遊戲。

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

成就清單的排序方向。

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

要包含在結果中的成就狀態。

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

AchievementsManager API 呼叫結果的控制代碼。其他 API 會使用此控制代碼來取得符合所呼叫 API 的成就物件。不再需要結果時，必須使用 [XblAchievementsManagerResultCloseHandle](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)


## Related topics

- [achievements_manager_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)
- [XBOX 成就管理員 API 概觀](https://docs.xbox.com/zh-TW/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievements](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerGetAchievement](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerUpdateAchievement](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)