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

# XblAchievement

> XblAchievement

# XblAchievement

도전 과제를 나타냅니다. 도전 과제는 모든 게임에서 일관되게 사용자의 게임 내 동작을 이끌고 보상하기 위한 시스템 전반의 메커니즘입니다.

## Syntax

```cpp theme={null}
typedef struct XblAchievement {  
    const char* id;  
    const char* serviceConfigurationId;  
    const char* name;  
    XblAchievementTitleAssociation* titleAssociations;  
    size_t titleAssociationsCount;  
    XblAchievementProgressState progressState;  
    XblAchievementProgression progression;  
    XblAchievementMediaAsset* mediaAssets;  
    size_t mediaAssetsCount;  
    const char** platformsAvailableOn;  
    size_t platformsAvailableOnCount;  
    bool isSecret;  
    const char* unlockedDescription;  
    const char* lockedDescription;  
    const char* productId;  
    XblAchievementType type;  
    XblAchievementParticipationType participationType;  
    XblAchievementTimeWindow available;  
    XblAchievementReward* rewards;  
    size_t rewardsCount;  
    uint64_t estimatedUnlockTime;  
    const char* deepLink;  
    bool isRevoked;  
} XblAchievement  
```

### Members

*id*\
Type: const char\*

UTF-8 인코딩된 도전 과제 ID입니다. uint를 나타냅니다.

*serviceConfigurationId*\
Type: const char\*

도전 과제와 연결된 Service Configuration ID(SCID)입니다. SCID는 대/소문자를 구분하는 것으로 간주되므로 Partner Center에서 직접 붙여넣습니다.

*name*\
Type: const char\*

UTF-8 인코딩된 지역화된 도전 과제 이름입니다.

*titleAssociations*\
Type: [XblAchievementTitleAssociation\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementtitleassociation)

도전 과제와 연결된 게임/앱 타이틀입니다.

*titleAssociationsCount*\
Type: size\_t

**titleAssociations**의 크기입니다.

*progressState*\
Type: [XblAchievementProgressState](/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

도전 과제 획득을 향한 사용자의 진행 상태입니다.

*progression*\
Type: [XblAchievementProgression](/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression)

요구 사항을 포함하여 도전 과제에 대한 진행 세부 정보를 포함하는 progression 개체입니다.

*mediaAssets*\
Type: [XblAchievementMediaAsset\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

도전 과제와 연결된 미디어 자산입니다(예: 이미지 ID).

*mediaAssetsCount*\
Type: size\_t

**mediaAssets**의 크기입니다.

*platformsAvailableOn*\
Type: const char\*\*

도전 과제를 사용할 수 있는 플랫폼의 UTF-8 인코딩된 컬렉션입니다.

*platformsAvailableOnCount*\
Type: size\_t

**platformsAvailableOn**의 크기입니다.

*isSecret*\
Type: bool

도전 과제가 비밀인지 여부입니다.

*unlockedDescription*\
Type: const char\*

잠금 해제된 도전 과제의 UTF-8 인코딩된 설명입니다.

*lockedDescription*\
Type: const char\*

잠긴 도전 과제의 UTF-8 인코딩된 설명입니다.

*productId*\
Type: const char\*

도전 과제가 함께 릴리스된 UTF-8 인코딩된 product\_id입니다. 이는 애플리케이션, 다운로드 가능 콘텐츠 등에 해당할 수 있는 전역적으로 고유한 식별자입니다.

*type*\
Type: [XblAchievementType](/reference/live/xsapi-c/achievements_c/enums/xblachievementtype)

도전 과제의 형식입니다(예: 챌린지 도전 과제).

*participationType*\
Type: [XblAchievementParticipationType](/reference/live/xsapi-c/achievements_c/enums/xblachievementparticipationtype)

도전 과제의 참여 형식입니다(예: 그룹 또는 개별).

*available*\
Type: [XblAchievementTimeWindow](/reference/live/xsapi-c/achievements_c/structs/xblachievementtimewindow)

도전 과제를 사용할 수 있는 시간 창입니다. Challenges에 적용됩니다.

*rewards*\
Type: [XblAchievementReward\*](/reference/live/xsapi-c/achievements_c/structs/xblachievementreward)

도전 과제가 잠금 해제될 때 플레이어가 획득하는 보상의 컬렉션입니다.

*rewardsCount*\
Type: size\_t

**rewards**의 크기입니다.

*estimatedUnlockTime*\
Type: uint64\_t

도전 과제를 획득하는 데 걸리는 예상 시간입니다.

*deepLink*\
Type: const char\*

도전 과제에 대해 원하는 시작점에서 타이틀을 시작할 수 있도록 하는 클라이언트용 UTF-8 인코딩된 딥 링크입니다.

*isRevoked*\
Type: bool

도전 과제가 시행에 의해 취소되었는지 여부를 나타내는 값입니다.

## Argument of

[XblAchievementsResultGetAchievements](/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements)

## Requirements

**Header:** achievements\_c.h

## See also

[achievements\_c](/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [XblAchievementsResultGetAchievements](/ko/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)
- [XblAchievementProgression](/ko/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression.md)
- [XblAchievementReward](/ko/reference/live/xsapi-c/achievements_c/structs/xblachievementreward.md)
- [XblAchievementType](/ko/reference/live/xsapi-c/achievements_c/enums/xblachievementtype.md)
- [XblAchievementsManagerResultGetAchievements](/ko/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)