Skip to main content

​
XblAchievementsUpdateAchievementForTitleIdAsync

Permite que o progresso das conquistas seja atualizado e que conquistas sejam desbloqueadas.

​
Sintaxe

​
Parâmetros

xboxLiveContext   _In_
Tipo: XblContextHandle Um identificador de contexto do Xbox Live criado com XblContextCreateHandle. xboxUserId   _In_
Tipo: uint64_t A ID de usuário do XBOX do jogador. titleId   _In_
Tipo: uint32_t A ID do título. 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. achievementId   _In_z_
Tipo: char* A ID da conquista codificada em UTF-8, conforme definida pelo XDP ou pelo Dev Center. percentComplete   _In_
Tipo: uint32_t A porcentagem de conclusão da conquista para indicar o progresso. Os valores válidos vão de 1 a 100. Defina como 100 para desbloquear a conquista. O progresso será definido pelo servidor como o valor mais alto enviado. async   _In_
Tipo: XAsyncBlock* AsyncBlock alocado pelo chamador.

​
Valor retornado

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

​
Comentários

Esta API funciona mesmo offline no PC e no XBOX One. As atualizações offline serão publicadas pelo sistema quando a conexão for restabelecida, mesmo que o título não esteja em execução. O resultado da operação assíncrona pode ser obtido chamando XAsyncGetStatus dentro do retorno de chamada do AsyncBlock ou após a conclusão do AsyncBlock. Se isso falhar inesperadamente, verifique se a SCID está correta em XblInitArgs, pois ela diferencia maiúsculas de minúsculas.

​
Chamada REST

V2 POST /users/xuid()/achievements//update

​
Requisitos

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

​
Confira também

achievements_c
Last modified on October 6, 2026