Pular para o conteúdo principal

XblAchievementsManagerAddLocalUser

Inicializa o Achievements Manager e gera um cache local de conquistas para um usuário.

Sintaxe

Parâmetros

user   _In_
Tipo: XblUserHandle
Usuário do XBOX Live para o qual as conquistas serão buscadas. queue   _In_opt_
Tipo: XTaskQueueHandle
Fila a ser usada para operações em segundo plano deste usuário (opcional).

Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

Comentários

Como XblAchievementsManagerAddLocalUser requer uma conexão com a Internet para rastrear corretamente as informações do usuário, ela só deve ser chamada enquanto houver conexão com a Internet. Usar XNetworkingRegisterConnectivityHintChanged é uma boa maneira de verificar a conexão. Se o Achievements Manager não estiver inicializado, as chamadas para XblAchievementsManagerUpdateAchievement falharão. Nesse caso, devem ser feitas chamadas para XblAchievementsUpdateAchievementAsync à medida que as condições das conquistas forem atendidas, para garantir que o progresso continue sendo rastreado. Veja um exemplo de como isso pode ser implementado:

Requisitos

Cabeçalho: achievements_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

achievements_manager_c
Última modificação em 6 de outubro de 2026