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

# 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](/pt-BR/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby)

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](/pt-BR/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder)

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

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

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

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

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](/pt-BR/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle) 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](/pt-BR/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members)


## Related topics

- [XblAchievementsManagerGetAchievementsByState](/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievementsbystate.md)
- [Overview of the XBOX Achievements Manager API](/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XBOX Achievements Manager API 개요](/ko/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [Información general sobre la API XBOX Achievements Manager](/es/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XBOX Achievements Manager API の概要](/ja-jp/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)