> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblAchievementsUpdateAchievementForTitleIdAsync

> XblAchievementsUpdateAchievementForTitleIdAsync

# XblAchievementsUpdateAchievementForTitleIdAsync

Permite actualizar el progreso de los logros y desbloquear logros.

## Sintaxis

```cpp theme={null}
HRESULT XblAchievementsUpdateAchievementForTitleIdAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         const uint32_t titleId,  
         const char* serviceConfigurationId,  
         const char* achievementId,  
         uint32_t percentComplete,  
         XAsyncBlock* async  
)  
```

### Parámetros

*xboxLiveContext*   \_In\_\
Tipo: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/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](/reference/system/xasync/functions/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({xuid})/achievements/{scid}/update

## Requisitos

**Encabezado:** achievements\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Consulte también

[achievements\_c](/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [Actualización de logros administrados por el título](/es/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [XblAchievementsUpdateAchievementAsync](/es/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](/es/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblAchievementsGetAchievementsForTitleIdResult](/es/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidresult.md)
- [Obtención de logros administrados por el título](/es/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-get-achievements.md)