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

Obtient la liste des succès d'un joueur qui se trouvent dans un état de progression donné.

## Syntaxe

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

### Paramètres

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

L'ID d'utilisateur XBOX du joueur.

*sortField*   \_In\_\
Type : [XblAchievementOrderBy](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementorderby)

Le champ selon lequel trier la liste des succès. TitleId se comporte de la même façon que DefaultOrder, car AchievementsManager ne gère qu'un seul titre à la fois.

*sortOrder*   \_In\_\
Type : [XblAchievementsManagerSortOrder](/fr-CA/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagersortorder)

Le sens dans lequel trier la liste des succès.

*achievementState*   \_In\_\
Type : [XblAchievementProgressState](/fr-CA/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

L'état de succès à inclure dans les résultats.

*achievementsResult*   \_Outptr\_result\_maybenull\_\
Type : [XblAchievementsManagerResultHandle\*](/fr-CA/reference/live/xsapi-c/achievements_manager_c/handles/xblachievementsmanagerresulthandle)

Le handle vers le résultat des appels d'API AchievementsManager. Ce handle est utilisé par d'autres API pour obtenir les objets de succès correspondant à l'API appelée. Le handle doit être fermé à l'aide de [XblAchievementsManagerResultCloseHandle](/fr-CA/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle) lorsque le résultat n'est plus nécessaire.

### Valeur de retour

Type : HRESULT

Code de retour HRESULT de cette opération d'API.

## Configuration requise

**En-tête :** achievements\_manager\_c.h

**Bibliothèque :** Microsoft.Xbox.Services.14x.GDK.C.lib

## Voir aussi

[achievements\_manager\_c](/fr-CA/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)