Skip to main content

​
XblUserStatisticsGetSingleUserStatisticsAsync

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

​
Sintaxe

​
Parâmetros

xblContextHandle   _In_
Tipo: 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 e 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, os nomes das estatísticas coincidirão com a instância de estatística de cada estatística. Se estiver usando estatísticas gerenciadas pelo título, 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()/scids//stats/,…,

​
Requisitos

Cabeçalho: user_statistics_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

​
Confira também

user_statistics_c
Last modified on October 6, 2026