Skip to main content

XblAchievementsUpdateAchievementForTitleIdAsync

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. titleId   _In_
Tipo: uint32_t
El id. del título. serviceConfigurationId   _In_z_
Tipo: char*
El identificador de configuración de servicio (SCID) del título. El SCID distingue mayúsculas de minúsculas, así que péguelo directamente desde Partner Center. 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 esto falla de forma inesperada, asegúrese de que el SCID esté correctamente en XblInitArgs, ya que distingue mayúsculas de minúsculas.

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