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 SeriesConfira também
XUserXUserCloseHandle
