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

Representa uma conquista, um mecanismo de todo o sistema para direcionar e recompensar as ações dos usuários nos jogos de forma consistente em todos os jogos.

## Sintaxe

```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  
```

### Membros

*id*\
Tipo: const char\*

A ID da conquista codificada em UTF-8. Representa um uint.

*serviceConfigurationId*\
Tipo: const char\*

A ID de configuração de serviço (SCID) associada à conquista. A SCID diferencia maiúsculas de minúsculas, portanto, cole-a diretamente do Partner Center

*name*\
Tipo: const char\*

O nome localizado da conquista codificado em UTF-8.

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

Os títulos de jogo/aplicativo associados à conquista.

*titleAssociationsCount*\
Tipo: size\_t

O tamanho de **titleAssociations**.

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

O estado do progresso de um usuário para obter a conquista.

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

O objeto de progressão que contém detalhes do progresso da conquista, incluindo os requisitos.

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

Os ativos de mídia associados à conquista, como IDs de imagem.

*mediaAssetsCount*\
Tipo: size\_t

O tamanho de **mediaAssets**.

*platformsAvailableOn*\
Tipo: const char\*\*

A coleção codificada em UTF-8 das plataformas nas quais a conquista está disponível.

*platformsAvailableOnCount*\
Tipo: size\_t

O tamanho de **platformsAvailableOn**.

*isSecret*\
Tipo: bool

Indica se a conquista é secreta ou não.

*unlockedDescription*\
Tipo: const char\*

A descrição da conquista desbloqueada codificada em UTF-8.

*lockedDescription*\
Tipo: const char\*

A descrição da conquista bloqueada codificada em UTF-8.

*productId*\
Tipo: const char\*

O product\_id codificado em UTF-8 com o qual a conquista foi lançada. É um identificador global exclusivo que pode corresponder a um aplicativo, conteúdo para download etc.

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

O tipo de conquista, como uma conquista de desafio.

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

O tipo de participação da conquista, como em grupo ou individual.

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

A janela de tempo durante a qual a conquista está disponível. Aplica-se a Desafios.

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

A coleção de recompensas que o jogador ganha quando a conquista é desbloqueada.

*rewardsCount*\
Tipo: size\_t

O tamanho de **rewards**.

*estimatedUnlockTime*\
Tipo: uint64\_t

O tempo estimado necessário para obter a conquista.

*deepLink*\
Tipo: const char\*

Um link profundo codificado em UTF-8 para clientes, que permite que o título seja iniciado em um ponto de partida desejado para a conquista.

*isRevoked*\
Tipo: bool

Um valor que indica se a conquista foi revogada pela fiscalização ou não.

## Argumento de

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

## Requisitos

**Cabeçalho:** achievements\_c.h

## Confira também

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


## Related topics

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