> ## 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 사용자 ID입니다.

*sortField*   \_In\_\
형식: [XblAchievementOrderBy](/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby)

업적 목록을 정렬할 필드입니다. AchievementsManager는 한 번에 하나의 타이틀만 처리하므로 TitleId는 DefaultOrder와 동일하게 동작합니다.

*sortOrder*   \_In\_\
형식: [XblAchievementsManagerSortOrder](/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder)

업적 목록을 정렬할 방향입니다.

*achievementState*   \_In\_\
형식: [XblAchievementProgressState](/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

결과에 포함할 업적 상태입니다.

*achievementsResult*   \_Outptr\_result\_maybenull\_\
형식: [XblAchievementsManagerResultHandle\*](/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle)

AchievementsManager API 호출 결과에 대한 핸들입니다. 이 핸들은 호출된 API에 해당하는 업적 개체를 가져오기 위해 다른 API에서 사용됩니다. 결과가 더 이상 필요하지 않은 경우 [XblAchievementsManagerResultCloseHandle](/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](/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XBOX Achievements Manager API 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievement](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerUpdateAchievement](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)
- [XblAchievementsManagerResultGetAchievements](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)