XGameUiShowWebAuthenticationAsync
Lance la demande d’authentification asynchrone qui affiche une interface utilisateur web permettant à l’utilisateur de déléguer l’accès à des sites et services web externes sans fournir directement ses informations d’identification au titre en cours d’exécution.Syntaxe
Paramètres
async _In_Type : XAsyncBlock* Pointeur vers le XAsyncBlock qui est passé à XAsyncRun. requestingUser _In_
Type : XUserHandle Handle de l’utilisateur qui demande l’authentification web. requestUri _In_z_
Type : char* URI initial de la vue web présentée à l’utilisateur (contenant probablement des champs permettant l’authentification de l’utilisateur auprès du service). L’URI de demande doit être une adresse HTTPS sécurisée. completionUri _In_z_
Type : char* Indique l’URI qui représente la réussite du processus d’authentification web. Lorsque la vue web accède à un URI qui correspond à completionUri, la vue web est fermée et le contrôle est rendu au titre appelant.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT de l’appel asynchrone. Pour obtenir le résultat, appelez xgameuishowwebauthenticationresultsize et xgameuishowwebauthenticationresult dans le rappel AsyncBlock ou une fois l’AsyncBlock terminé.Remarques
Lorsque cette tâche asynchrone s’exécute, le système présente à l’utilisateur une vue web (superposée à l’application actuelle), avec laquelle il peut interagir ou qu’il peut fermer en appuyant sur Retour. Cela permet aux utilisateurs d’utiliser OAuth pour accorder une autorisation à des sites et services web externes. Cela peut être utilisé dans des scénarios tels que l’authentification du jeu pour partager des temps forts du jeu sur les réseaux sociaux, la demande de données utilisateur auprès de fournisseurs externes, etc. Le résultat de la demande d’authentification est stocké dans l’objet XGameUiWebAuthenticationResultData retourné par la méthode XGameUiShowWebAuthenticationResult. Si la vue web est fermée à la suite de l’accès à completionUri, le champ responseStatus de la structure de données de résultat a la valeurS_OK.
Si l’utilisateur annule ou ferme manuellement la vue web d’une autre manière, le champ responseStatus de la structure de données de résultat a la valeur E_CANCELLED.
Exemple
L’exemple de code suivant montre comment effectuer une authentification OAuth à l’aide de Facebook. Pour que le code reste concis, cet exemple n’inclut pas la gestion des erreurs d’allocation de mémoire.Configuration requise
En-tête : XGameUI.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
XGameUI XGameUiShowWebAuthenticationWithOptionsAsync XGameUiShowWebAuthenticationResultSizeXGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
Modèle de programmation asynchrone
