XGameUiShowWebAuthenticationWithOptionsAsync
Inicia a solicitação de autenticação assíncrona que exibe uma interface do usuário da Web, possivelmente em tela inteira, que permite ao usuário delegar acesso a sites e serviços externos sem fornecer diretamente suas credenciais ao título em execução.Sintaxe
Parâmetros
async _In_Tipo: XAsyncBlock* Um ponteiro para o XAsyncBlock que é passado para XAsyncRun. requestingUser _In_
Tipo: XUserHandle Um identificador para o usuário que está solicitando a autenticação na Web. requestUri _In_z_
Tipo: char* O URI inicial do modo de exibição da Web apresentado ao usuário (provavelmente contendo campos para a autenticação do usuário no serviço). O URI de solicitação deve ser um endereço HTTPS seguro. completionUri _In_z_
Tipo: char* Indica o URI que representa a conclusão bem-sucedida do processo de autenticação na Web. Quando o modo de exibição da Web navega para um URI que corresponde a completionUri, o modo de exibição da Web é fechado e o controle é devolvido ao título que fez a chamada. options &nbps; _In_ Tipo: XGameUiWebAuthenticationOptions Sinalizador que indica se deve ou não tentar mostrar a interface do usuário em tela inteira. No PC, esse sinalizador é ignorado. A tela inteira não é uma opção com suporte no PC.
Valor retornado
Tipo: HRESULT Código de êxito ou de erro HRESULT da chamada assíncrona. Para obter o resultado, chame xgameuishowwebauthenticationresultsize e xgameuishowwebauthenticationresult dentro do retorno de chamada do AsyncBlock ou após a conclusão do AsyncBlock.Comentários
Quando essa tarefa assíncrona é executada, o sistema apresenta ao usuário um modo de exibição da Web (sobreposto ao aplicativo atual), com o qual ele pode interagir ou que pode descartar pressionando Voltar. Isso permite que os usuários usem o OAuth para conceder permissão de autorização a sites e serviços externos. Isso pode ser usado em cenários como autenticar o jogo para compartilhar destaques do jogo em redes sociais, solicitar dados do usuário a provedores externos e muito mais. O resultado da solicitação de autenticação é armazenado no objeto XGameUiWebAuthenticationResultData, que é retornado pelo método XGameUiShowWebAuthenticationResult. Se o modo de exibição da Web for fechado como resultado da navegação para completionUri, o campo responseStatus da estrutura de dados do resultado seráS_OK.
Se o usuário cancelar ou fechar manualmente o modo de exibição da Web de outra forma, o campo responseStatus da estrutura de dados do resultado será E_CANCELLED.
Exemplo
O exemplo de código a seguir mostra como executar o OAuth usando o Facebook. Este exemplo não inclui o tratamento de erros de alocação de memória para manter o código breve.Requisitos
Cabeçalho: XGameUI.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
XGameUI XGameUiShowWebAuthenticationAsyncXGameUiShowWebAuthenticationResultSize
XGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
Modelo de programação assíncrona
