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

Obtient la liste des succès d'un joueur se trouvant dans un état de progression spécifique.

## Syntaxe

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

### Paramètres

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

ID utilisateur XBOX du joueur.

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

Champ sur lequel trier la liste des succès. TitleId se comporte comme DefaultOrder, car AchievementsManager ne gère qu'un seul titre à la fois.

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

Sens dans lequel trier la liste des succès.

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

État des succès à inclure dans les résultats.

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

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](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultclosehandle.md) 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](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)


## Related topics

- [achievements_manager_c](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/achievements_manager_c_members.md)
- [Vue d'ensemble de l'API XBOX Achievements Manager](https://docs.xbox.com/fr/services/xbox-services/player-data/achievements/achievements-manager/live-achievements-manager-overview.md)
- [XblAchievementsManagerGetAchievement](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievement.md)
- [XblAchievementsManagerGetAchievements](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagergetachievements.md)
- [XblAchievementsManagerUpdateAchievement](https://docs.xbox.com/fr/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)