> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblAchievementsManagerGetAchievementsByState

> XblAchievementsManagerGetAchievementsByState

# XblAchievementsManagerGetAchievementsByState

Obtém uma lista de conquistas em um estado de progresso específico para um jogador.

## Sintaxe

```cpp theme={null}
HRESULT XblAchievementsManagerGetAchievementsByState(  
         uint64_t xboxUserId,  
         XblAchievementOrderBy sortField,  
         XblAchievementsManagerSortOrder sortOrder,  
         XblAchievementProgressState achievementState,  
         XblAchievementsManagerResultHandle* achievementsResult  
)  
```

### Parâmetros

*xboxUserId*   \_In\_\
Tipo: uint64\_t

A ID de usuário do XBOX do jogador.

*sortField*   \_In\_\
Tipo: [XblAchievementOrderBy](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby.md)

O campo pelo qual a lista de conquistas será classificada. TitleId se comportará da mesma forma que DefaultOrder, pois o AchievementsManager lida com apenas um título por vez.

*sortOrder*   \_In\_\
Tipo: [XblAchievementsManagerSortOrder](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder.md)

A direção na qual a lista de conquistas será classificada.

*achievementState*   \_In\_\
Tipo: [XblAchievementProgressState](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate.md)

O estado de conquista a ser incluído nos resultados.

*achievementsResult*   \_Outptr\_result\_maybenull\_\
Tipo: [XblAchievementsManagerResultHandle\*](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle.md)

O identificador do resultado das chamadas de API do AchievementsManager. Esse identificador é usado por outras APIs para obter os objetos de conquista correspondentes à API chamada. O identificador deve ser fechado usando [XblAchievementsManagerResultCloseHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle.md) quando o resultado não for mais necessário.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT para esta operação de API.

## Requisitos

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

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[achievements\_manager\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)


## Related topics

- [achievements_manager_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)
- [Visão geral da API Achievements Manager do XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievement](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerUpdateAchievement](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)