Skip to main content

XblAchievementsManagerGetAchievementsByState

플레이어의 특정 진행 상태에 있는 업적 목록을 가져옵니다.

구문

매개 변수

xboxUserId   _In_
형식: uint64_t
플레이어의 XBOX 사용자 ID입니다. sortField   _In_
형식: XblAchievementOrderBy
업적 목록을 정렬할 필드입니다. AchievementsManager는 한 번에 하나의 타이틀만 처리하므로 TitleId는 DefaultOrder와 동일하게 동작합니다. sortOrder   _In_
형식: XblAchievementsManagerSortOrder
업적 목록을 정렬할 방향입니다. achievementState   _In_
형식: XblAchievementProgressState
결과에 포함할 업적 상태입니다. achievementsResult   _Outptr_result_maybenull_
형식: XblAchievementsManagerResultHandle*
AchievementsManager API 호출 결과에 대한 핸들입니다. 이 핸들은 호출된 API에 해당하는 업적 개체를 가져오기 위해 다른 API에서 사용됩니다. 결과가 더 이상 필요하지 않은 경우 XblAchievementsManagerResultCloseHandle을 사용하여 핸들을 닫아야 합니다.

반환값

형식: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.

요구 사항

헤더: achievements_manager_c.h 라이브러리: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

achievements_manager_c
마지막 수정일 2026년 8월 24일