Skip to main content

​
XblAchievementsUpdateAchievementAsync

Permite actualizar el progreso de los logros y desbloquear logros.

​
Sintaxis

​
Parámetros

xboxLiveContext   _In_
Tipo: XblContextHandle Identificador de contexto de xbox live creado con XblContextCreateHandle. xboxUserId   _In_
Tipo: uint64_t Id. de usuario de XBOX del jugador. achievementId   _In_z_
Tipo: char* El identificador del logro codificado en UTF-8 tal como se define en XDP o Dev Center. percentComplete   _In_
Tipo: uint32_t El porcentaje de finalización del logro para indicar el progreso. Los valores válidos van de 1 a 100. Establézcalo en 100 para desbloquear el logro. El servidor establecerá el progreso en el valor más alto enviado async   _In_
Tipo: XAsyncBlock* AsyncBlock asignado por el autor de la llamada.

​
Valor devuelto

Tipo: HRESULT Código de retorno HRESULT de esta operación de API.

​
Comentarios

Esta API funcionará incluso sin conexión en PC y XBOX One. El sistema publicará las actualizaciones sin conexión cuando se restablezca la conexión, aunque el título no se esté ejecutando. El resultado de la operación asincrónica se puede obtener llamando a XAsyncGetStatus dentro de la devolución de llamada de AsyncBlock o después de que se complete AsyncBlock. Si el logro ya se ha desbloqueado o el valor de progreso es menor o igual que el registrado actualmente en el servidor, XAsyncGetStatus() dentro de la devolución de llamada devolverá HTTP_E_STATUS_NOT_MODIFIED (0x80190130L).

​
Llamada REST

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

​
Requisitos

Encabezado: achievements_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

​
Consulte también

achievements_c
Última modificación el 28 de agosto de 2026

Temas relacionados

Contenedores de API de C# de Unity para el GDKActualización de logros administrados por el títuloXblAchievementsManagerAddLocalUserEstadísticas y logrosXblAchievementsUpdateAchievementForTitleIdAsync