XUserAddResult
Recupera um identificador para um usuário criado por XUserAddAsync.Sintaxe
Parâmetros
async _Inout_Tipo: XAsyncBlock* O bloco assíncrono enviado para XUserAddAsync. newUser _Out_
Tipo: XUserHandle* Contém um identificador para o novo usuário.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
XUserAddAsync inicia uma operação assíncrona para adicionar um usuário ao jogo. Use XUserAddResult para recuperar os resultados da operação. XUserAddAsync sempre exibe uma interface do usuário do seletor de contas, a menos que você passe XUserAddOptions::AddDefaultUserSilently para o parâmetro options. Se você usar XUserAddOptions::AddDefaultUserSilently, XUserAddAsync não exibirá uma interface do usuário. O usuário retornado por XUserAddOptions::AddDefaultUserSilently continuará sendo retornado até que o usuário saia. Se um usuário padrão não estiver disponível, XUserAddResult retornará E_GAMEUSER_NO_DEFAULT_USER. Isso indica que você deve chamar XUserAddAsync sem XUserAddOptions::AddDefaultUserSilently para selecionar um usuário. Se um usuário estiver banido do XBOX Live, o jogo não poderá obter um XUserHandle para esse usuário. Se XUserAddOptions::AddDefaultUserSilently for usado e o jogo tiver sido iniciado por um usuário banido, XUserAddResult retornará E_GAMEUSER_NO_DEFAULT_USER. Caso contrário, se a interface do usuário for exibida, um usuário não banido precisará entrar ou o usuário precisará cancelar a interface do usuário, e XUserAddResult retornará E_ABORT. Você não pode usar XUserAddOptions::AllowGuests com XUserAddOptions::AddDefaultUserSilently. Um convidado não pode ser o usuário padrão. Você pode usar XUserAddOptions::AllowGuests com segurança, independentemente de a plataforma atual oferecer suporte a convidados. Você deve fechar cada identificador XUserHandle recuperado de uma API XUsers uma vez, chamando XUserCloseHandle. O exemplo a seguir demonstra como adicionar um usuário a uma sessão de jogo de forma assíncrona.Requisitos
Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows,Steam Deck, consoles da família XBOX One e consoles XBOX SeriesDocumentação conceitual
- Executar tarefa de API do Microsoft Game Development Kit (GDK)
- Metas de design e melhorias da programação assíncrona
