Skip to main content

​
XblAchievementsManagerUpdateAchievement

Permite actualizar el progreso de los logros y desbloquear logros.

​
Sintaxis

​
Parámetros

xboxUserId   _In_
Tipo: uint64_t El identificador de usuario de XBOX del jugador. achievementId   _In_
Tipo: char* El identificador del logro codificado en UTF-8 tal como se define en el Centro de desarrollo. currentProgess   _In_
Tipo: uint8_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.

​
Valor devuelto

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

​
Comentarios

Suponiendo que el administrador de logros se haya inicializado correctamente con XblAchievementsManagerAddLocalUser, esta API funcionará incluso sin conexión en PC y en consolas XBOX. El sistema publicará las actualizaciones sin conexión cuando se restablezca la conexión, incluso si el título no se está ejecutando. El resultado de la operación no se representará localmente de inmediato. Lo más pronto que se reflejará la actualización será después de la llamada a DoWork del siguiente fotograma. Una vez que se refleje el cambio, la matriz devuelta por DoWork contendrá un XblAchievementsManagerEvent con un tipo de evento AchievementProgressUpdated y, posiblemente, un evento adicional de tipo AchievementUnlocked si el nuevo progreso desbloqueó el logro. Si el logro ya se ha desbloqueado o el valor de progreso es menor o igual que el almacenado en caché desde el servidor, esta función devolverá E_NOT_VALID_STATE o E_INVALIDARG respectivamente. Solo los logros basados en el título se pueden actualizar con esta función. Los logros basados en eventos no se pueden actualizar con esta función.

​
Llamada REST

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

​
Requisitos

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

​
Consulte también

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

Temas relacionados

Información general sobre la API XBOX Achievements ManagerXblAchievementsManagerAddLocalUserXblAchievementsUpdateAchievementAsyncXblAchievementsManagerGetAchievementsXblAchievementsManagerGetAchievement