> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

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](https://docs.xbox.com/pt-BR/reference/system/xasync/functions/xasyncgetstatus.md) 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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/achievements_c_members.md)


## Related topics

- [Atualizando conquistas gerenciadas pelo título](https://docs.xbox.com/pt-BR/services/xbox-services/player-data/achievements/title-managed/how-to/live-how-to-update-achievements.md)
- [achievements_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/achievements_c_members.md)
- [XblAchievementsUpdateAchievementAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/functions/xblachievementsupdateachievementasync.md)
- [XblAchievementsGetAchievementsForTitleIdAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblAchievementsGetAchievementsForTitleIdResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidresult.md)