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

# XblUserStatisticsGetSingleUserStatisticsAsync

> XblUserStatisticsGetSingleUserStatisticsAsync

# XblUserStatisticsGetSingleUserStatisticsAsync

Obtém estatísticas especificadas de um único usuário.

## Sintaxe

```cpp theme={null}
HRESULT XblUserStatisticsGetSingleUserStatisticsAsync(  
         XblContextHandle xblContextHandle,  
         uint64_t xboxUserId,  
         const char* serviceConfigurationId,  
         const char** statisticNames,  
         size_t statisticNamesCount,  
         XAsyncBlock* async  
)  
```

### Parâmetros

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

Contexto do XBOX live para o usuário local.

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

A ID de usuário do XBOX do jogador do qual obter estatísticas.

*serviceConfigurationId*   \_In\_z\_\
Tipo: char\*

A ID de configuração de serviço (SCID) do título. A SCID diferencia maiúsculas de minúsculas, portanto, cole-a diretamente do Partner Center.

*statisticNames*   \_In\_\
Tipo: char\*\*

Uma coleção de nomes de estatísticas a serem pesquisados.

*statisticNamesCount*   \_In\_\
Tipo: size\_t

O número de nomes de estatísticas.

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

O AsyncBlock desta operação.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Chame [XblUserStatisticsGetSingleUserStatisticsResultSize](/pt-BR/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresultsize) e [XblUserStatisticsGetSingleUserStatisticsResult](/pt-BR/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult) após a conclusão para obter o resultado. Somente estatísticas com valores são retornadas. Por exemplo, se você solicitar 3 nomes de estatísticas e apenas 2 tiverem valores, somente 2 estatísticas serão retornadas pelo serviço.

Se estiver usando [estatísticas baseadas em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview), os nomes das estatísticas coincidirão com a [instância de estatística](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview#defining-stat-instances) de cada estatística. Se estiver usando [estatísticas gerenciadas pelo título](/pt-BR/services/xbox-services/player-data/stats-leaderboards/title-managed/live-stats-tm-overview), os nomes das estatísticas coincidirão com a ID de cada estatística.

As estatísticas solicitadas por meio desta API são transformadas em uma lista delimitada por vírgulas que tem um limite de 260 caracteres.  Se um erro 400 for recebido ao chamar este método, tente solicitar menos estatísticas para encurtar o comprimento dessa cadeia de caracteres transformada.

## Chamada REST

V1 GET /users/xuid({xuid})/scids/{scid}/stats/{statname1},...,{statnameN}

## Requisitos

**Cabeçalho:** user\_statistics\_c.h

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

## Confira também

[user\_statistics\_c](/pt-BR/reference/live/xsapi-c/user_statistics_c/user_statistics_c_members)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)
- [XblUserStatisticsGetSingleUserStatisticsResult](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsresult.md)