Skip to main content

XGameUiShowWebAuthenticationAsync

Inicia la solicitud de autenticación asincrónica que muestra una interfaz de usuario web que permite al usuario delegar el acceso a sitios web y servicios externos sin proporcionar directamente sus credenciales al título en ejecución.

Sintaxis

Parámetros

async   _In_
Tipo: XAsyncBlock*
Un puntero al XAsyncBlock que se pasa a XAsyncRun. requestingUser   _In_
Tipo: XUserHandle
Un identificador del usuario que solicita la autenticación web. requestUri   _In_z_
Tipo: char*
El URI inicial de la vista web presentada al usuario (que probablemente contiene campos para la autenticación del usuario en el servicio). El URI de la solicitud debe ser una dirección HTTPS segura. completionUri   _In_z_
Tipo: char*
Indica el URI que representa la finalización correcta del proceso de autenticación web. Cuando la vista web navega a un URI que coincide con completionUri, la vista web se cierra y el control se devuelve al título que realizó la llamada.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error de la llamada asincrónica. Para obtener el resultado, llame a xgameuishowwebauthenticationresultsize y xgameuishowwebauthenticationresult dentro de la devolución de llamada de AsyncBlock o después de que AsyncBlock se haya completado.

Comentarios

Cuando se ejecuta esta tarea asincrónica, el sistema presenta una vista web al usuario (superpuesta a la aplicación actual), con la que puede interactuar o que puede descartar presionando atrás. Esto permite a los usuarios usar OAuth para conceder permisos de autorización a sitios web y servicios externos. Esto se puede usar en escenarios como autenticar el juego para compartir momentos destacados del juego en redes sociales, solicitar datos de usuario de proveedores externos y mucho más. El resultado de la solicitud de autenticación se almacena en el objeto XGameUiWebAuthenticationResultData que devuelve el método XGameUiShowWebAuthenticationResult. Si la vista web se cierra como resultado de navegar al completionUri, el campo responseStatus de la estructura de datos de resultado será S_OK. Si el usuario cancela o cierra manualmente la vista web de otra manera, el campo responseStatus de la estructura de datos de resultado será E_CANCELLED.

Ejemplo

El siguiente ejemplo de código muestra cómo realizar OAuth mediante Facebook. Este ejemplo no incluye el control de errores de asignación de memoria para mantener el código breve.

Requisitos

Encabezado: XGameUI.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XGameUI XGameUiShowWebAuthenticationWithOptionsAsync XGameUiShowWebAuthenticationResultSize
XGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
Modelo de programación asincrónica
Última modificación el 28 de agosto de 2026