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

# 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](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby)

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

*sortOrder*   \_In\_\
類型：[XblAchievementsManagerSortOrder](/zh-TW/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder)

成就清單的排序方向。

*achievementState*   \_In\_\
類型：[XblAchievementProgressState](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

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

*achievementsResult*   \_Outptr\_result\_maybenull\_\
類型：[XblAchievementsManagerResultHandle\*](/zh-TW/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle)

AchievementsManager API 呼叫結果的控制代碼。其他 API 會使用此控制代碼來取得符合所呼叫 API 的成就物件。不再需要結果時，必須使用 [XblAchievementsManagerResultCloseHandle](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle) 關閉此控制代碼。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 需求

**標頭：** achievements\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[achievements\_manager\_c](/zh-TW/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

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