> ## 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 que o progresso das conquistas seja atualizado e que conquistas sejam desbloqueadas.

## Sintaxe

```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](/pt-BR/reference/live/xsapi-c/types_c/handles/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](/pt-BR/reference/system/xasync/functions/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({xuid})/achievements/{scid}/update

## Requisitos

**Cabeçalho:** achievements\_c.h

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

## Confira também

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


## Related topics

- [XblAchievementsUpdateAchievementForTitleIdAsync](/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementfortitleidasync.md)
- [Updating title-managed Achievements](/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [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)
- [更新作品管理的成就](/zh-CN/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [타이틀 관리형 업적 업데이트](/ko/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)