Skip to main content

XblAchievementsManagerGetAchievements

플레이어의 모든 업적 목록을 가져옵니다.

구문

매개 변수

xboxUserId   _In_
형식: uint64_t
플레이어의 XBOX 사용자 ID입니다. sortField   _In_
형식: XblAchievementOrderBy
업적 목록을 정렬할 필드입니다. sortOrder   _In_
형식: XblAchievementsManagerSortOrder
업적 목록을 정렬할 방향입니다. achievementsResult   _Outptr_result_maybenull_
형식: XblAchievementsManagerResultHandle*
AchievementsManager API 호출 결과에 대한 핸들입니다. 이 핸들은 호출된 API에 해당하는 업적 개체를 가져오기 위해 다른 API에서 사용됩니다. 결과가 더 이상 필요하지 않은 경우 XblAchievementsManagerResultCloseHandle을 사용하여 핸들을 닫아야 합니다.

반환값

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

설명

sortField로 XblAchievementOrderBy::TitleId를 전달하면 업적 관리자가 추적하는 모든 업적이 동일한 TitleId를 갖게 되므로 XblAchievementOrderBy::DefaultOrder를 전달하는 것과 동일한 결과를 얻을 수 있습니다.

요구 사항

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

참고 항목

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