Skip to main content

XUserAddByIdWithUiAsync

Adiciona de forma assíncrona um usuário a uma sessão de jogo com base em um XUID de um convite de jogo. Esta função só deve ser usada em resposta a um convite de jogo.

Sintaxe

Parâmetros

userId   _In_
Tipo: uint64_t
XUID do usuário a ser adicionado. Esse XUID deve ser obtido analisando o inviteUri recebido no retorno de chamada do jogo que foi registrado com XGameInviteRegisterForEvent. async   _Inout_
Tipo: XAsyncBlock*
Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

XUserAddByIdWithUiAsync inicia uma operação assíncrona para adicionar um usuário ao jogo. Use XUserAddByIdWithUiResult para recuperar os resultados da operação. Ao lidar com convites de jogo, sempre existe a possibilidade, no console, de que o XUID da pessoa especificada no convite de jogo não seja a pessoa que já está conectada ao jogo. XUserAddByIdWithUiAsync permite que o jogo adicione esse usuário usando o XUID analisado do URI do convite. Esta função tentará adicionar o usuário sem exibir a interface do usuário. O único motivo pelo qual a interface do usuário pode ser exibida é que o usuário precisa resolver um problema com seu token. No console, a exibição da interface do usuário deve ser incomum. Se o usuário não estiver conectado ao dispositivo, XUserAddByIdWithUiResult retornará E_GAMEUSER_USER_NOT_FOUND. Você deve fechar cada identificador XUserHandle recuperado de uma API XUsers apenas uma vez, chamando XUserCloseHandle. Para receber convites de jogo, os desenvolvedores devem assinar o XGameInviteCallback chamando XGameInviteRegisterForEvent. Quando esse retorno de chamada for invocado, os jogos devem analisar o inviteUri recebido e determinar o XUID do usuário que está recebendo o convite. Nesse ponto, o jogo pode querer obter um XUserHandle para a pessoa que está recebendo o convite. O código a seguir demonstra como isso funciona.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, , Steam Deck, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser
XUserCloseHandle
Last modified on October 6, 2026