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

# XblLeaderboardQuery

> XblLeaderboardQuery

# XblLeaderboardQuery

Représente les paramètres permettant d'envoyer une requête de classement à l'aide de statistiques basées sur les événements ou sur le titre.

## Syntaxe

```cpp theme={null}
typedef struct XblLeaderboardQuery {  
    uint64_t xboxUserId;  
    char scid[XBL_SCID_LENGTH];  
    const char* leaderboardName;  
    const char* statName;  
    XblSocialGroupType socialGroup;  
    const char** additionalColumnleaderboardNames;  
    size_t additionalColumnleaderboardNamesCount;  
    XblLeaderboardSortOrder order;  
    uint32_t maxItems;  
    uint64_t skipToXboxUserId;  
    uint32_t skipResultToRank;  
    const char* continuationToken;  
    XblLeaderboardQueryType queryType;  
} XblLeaderboardQuery  
```

### Membres

*xboxUserId*\
Type : uint64\_t

ID utilisateur XBOX facultatif de l'utilisateur demandeur. Pour un classement global, définissez-le sur 0.

*scid*\
Type : char\[XBL\_SCID\_LENGTH]

ID de configuration de service (SCID) du titre, encodé en UTF-8.

*leaderboardName*\
Type : const char\*

Nom facultatif, encodé en UTF-8, du classement à obtenir. Définissez-le sur nullptr si vous interrogez un classement social ou un classement reposant sur une statistique gérée par le titre.

*statName*\
Type : const char\*

Nom facultatif, encodé en UTF-8, de la statistique pour laquelle obtenir un classement. Utilisé lors de l'interrogation d'un classement social ou d'un classement reposant sur une statistique gérée par le titre.

*socialGroup*\
Type : [XblSocialGroupType](/fr/reference/live/xsapi-c/leaderboard_c/enums/xblsocialgrouptype)

Facultatif. Groupe social d'utilisateurs pour lequel obtenir les résultats du classement, par exemple pour obtenir un classement « amis uniquement ». Définissez-le sur XblSocialGroupType\_None pour obtenir un classement global.

*additionalColumnleaderboardNames*\
Type : const char\*\*

Tableau facultatif, encodé en UTF-8, des noms de statistiques pour les colonnes supplémentaires.

*additionalColumnleaderboardNamesCount*\
Type : size\_t

Nombre facultatif de additionalColumnleaderboardNames transmis.

*order*\
Type : [XblLeaderboardSortOrder](/fr/reference/live/xsapi-c/leaderboard_c/enums/xblleaderboardsortorder)

Définit l'ordre de tri du classement obtenu.

*maxItems*\
Type : uint32\_t

Définit le nombre maximal d'éléments que contient le classement obtenu. Définissez-le sur 0 pour laisser le service renvoyer le nombre maximal d'éléments par défaut.

*skipToXboxUserId*\
Type : uint64\_t

Définit l'utilisateur autour duquel le classement obtenu est centré. Définissez-le sur 0 pour ne pas passer à un utilisateur spécifique.

*skipResultToRank*\
Type : uint32\_t

Définit le rang autour duquel le classement obtenu est centré. Définissez-le sur 0 pour ne pas passer à un rang spécifique.

*continuationToken*\
Type : const char\*

continuationToken, encodé en UTF-8, utilisé pour obtenir le jeu suivant de données de classement.

*queryType*\
Type : [XblLeaderboardQueryType](/fr/reference/live/xsapi-c/leaderboard_c/enums/xblleaderboardquerytype)

Type de classement à interroger.

## Membre de

[XblLeaderboardResult](/fr/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardresult)

## Argument de

[XblLeaderboardGetLeaderboardAsync](/fr/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync)

## Remarques

### Statistiques basées sur les événements

Lorsque vous utilisez le membre *statName* avec des [statistiques basées sur les événements](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview), la valeur doit correspondre à une [instance de statistique](/fr/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances).

### Statistiques gérées par le titre

Lorsque vous utilisez des [statistiques gérées par le titre](/fr/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview) pour les classements, définir *skipToXboxUserId* sur une valeur non nulle compare la statistique stockée du *xboxUserId* donné au classement global.

De même, définir *socialGroup* sur People ou Favorites compare les statistiques stockées du *xboxUserId* donné et des utilisateurs associés. Les valeurs du classement global ne sont pas utilisées.

**Notez que lorsque la statistique stockée d'un joueur et son score dans le classement global ne sont pas identiques, les résultats obtenus peuvent ne pas concorder.**

<Info>
  Pour les statistiques gérées par le titre, l'entrée d'un joueur dans le classement global n'est pas une projection directe de sa statistique stockée actuelle. Le service de classement **conserve uniquement la valeur la plus élevée enregistrée** pour chaque joueur. Par conséquent, **écrire une valeur inférieure dans une statistique ne fait pas baisser la position de ce joueur dans le classement global** ; le classement continue de refléter le maximum enregistré précédemment. La statistique stockée elle-même, interrogeable via `XblUserStatisticsGet*` ou `XblTitleManagedStatsGetForUserAsync`, reflète la dernière valeur écrite, ce qui explique pourquoi elle peut différer du classement.

  Si votre titre a besoin que les positions dans le classement puissent baisser, les statistiques gérées par le titre ne conviennent pas. Par exemple, une évaluation qui peut augmenter ou diminuer, ou un score qui est réinitialisé en cas de défaite. Envisagez plutôt des statistiques basées sur les événements avec une règle `Replace`, ou un service de classement externe tel que [PlayFab Leaderboards v2](/fr/services/playfab/community/leaderboards/index). Pour plus d'informations sur ce comportement, consultez les [notes d'implémentation](https://github.com/microsoft/Xbox-GDK-Samples/blob/main/Samples/Live/LeaderboardsTitleManaged/readme_en-us.md) de l'exemple `LeaderboardsTitleManaged` du Microsoft Game Development Kit (GDK).
</Info>

## Configuration requise

**En-tête :** leaderboard\_c.h

## Voir aussi

[leaderboard\_c](/fr/reference/live/xsapi-c/leaderboard_c/leaderboard_c_members)\
[Statistiques basées sur les événements et statistiques gérées par le titre](/fr/services/xbox-services/player-data/stats-leaderboards/live-stats-eb-vs-tm)


## Related topics

- [XblLeaderboardQuery](/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery.md)
- [XblLeaderboardQueryType](/reference/live/xsapi-c/leaderboard_c/enums/xblleaderboardquerytype.md)
- [Leaderboards](/build/steam-porting-guide/features/steam-leaderboards.md)
- [Getting a title-managed leaderboard](/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-getting-tm-leaderboard.md)
- [XblLeaderboardGetLeaderboardAsync](/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardasync.md)