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

# XblLeaderboardGetLeaderboardAsync

> XblLeaderboardGetLeaderboardAsync

# XblLeaderboardGetLeaderboardAsync

Obtém um placar de líderes para um título usando estatísticas baseadas em eventos ou baseadas no título.

## Sintaxe

```cpp theme={null}
HRESULT XblLeaderboardGetLeaderboardAsync(  
         XblContextHandle xboxLiveContext,  
         XblLeaderboardQuery leaderboardQuery,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xboxLiveContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Um identificador de contexto do Xbox Live criado com XblContextCreateHandle.

*leaderboardQuery*   \_In\_\
Tipo: [XblLeaderboardQuery](/pt-BR/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery)

Os parâmetros de consulta da solicitação de placar de líderes.

*async*   \_In\_\
Tipo: XAsyncBlock\*

AsyncBlock alocado pelo chamador.

### Valor retornado

Tipo: HRESULT

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

## Chamada REST

V4 GET https: // leaderboards.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/{statname}/people/{all|favorites}\[?sort=descending|ascending]\&skipToUser={skipToUser}

## Requisitos

**Cabeçalho:** leaderboard\_c.h

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

## Confira também

[leaderboard\_c](/pt-BR/reference/live/xsapi-c/leaderboard_c/leaderboard_c_members)


## Related topics

- [XblLeaderboardGetLeaderboardResult](/pt-BR/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresult.md)
- [XblLeaderboardGetLeaderboardResultSize](/pt-BR/reference/live/xsapi-c/leaderboard_c/functions/xblleaderboardgetleaderboardresultsize.md)
- [XblLeaderboardQuery](/pt-BR/reference/live/xsapi-c/leaderboard_c/structs/xblleaderboardquery.md)
- [Obter um leaderboard gerenciado pelo título](/pt-BR/services/xbox-services/player-data/stats-leaderboards/title-managed/how-to/live-getting-tm-leaderboard.md)
- [Código de exemplo para leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/how-to/live-leaderboards-eb-howto.md)