Skip to main content

XUserAddByIdWithUiAsync

Agrega de forma asincrónica un usuario a una sesión de juego basándose en un XUID procedente de una invitación de juego. Esta función solo debe usarse en respuesta a una invitación de juego.

Sintaxis

Parámetros

userId   _In_
Tipo: uint64_t
XUID del usuario que se va a agregar. Este XUID debe obtenerse analizando el inviteUri recibido en la devolución de llamada del juego que se registró con XGameInviteRegisterForEvent. async   _Inout_
Tipo: XAsyncBlock*
Un XAsyncBlock para sondear el estado de la llamada y recuperar los resultados de la llamada.

Valor devuelto

Tipo: HRESULT Código de error o de operación correcta HRESULT. Para obtener una lista de códigos de error, consulte Códigos de error.

Comentarios

XUserAddByIdWithUiAsync inicia una operación asincrónica para agregar un usuario al juego. Use XUserAddByIdWithUiResult para recuperar los resultados de la operación. Al trabajar con invitaciones de juego, en consola siempre existe la posibilidad de que el XUID de la persona especificada en la invitación de juego no sea la persona que ya ha iniciado sesión en el juego. XUserAddByIdWithUiAsync permite al juego agregar ese usuario mediante el XUID que se analiza a partir del URI de la invitación. Esta función intentará agregar el usuario sin mostrar interfaz de usuario. La única razón por la que puede mostrarse una interfaz de usuario es que el usuario necesite resolver un problema con su token. En consola, mostrar la interfaz de usuario debería ser poco frecuente. Si el usuario no ha iniciado sesión en el dispositivo, XUserAddByIdWithUiResult devolverá E_GAMEUSER_USER_NOT_FOUND. Debe cerrar cada identificador XUserHandle que recupere de una API de XUsers una sola vez llamando a XUserCloseHandle. Para obtener invitaciones de juego, los desarrolladores deben suscribirse a XGameInviteCallback llamando a XGameInviteRegisterForEvent. Cuando se invoca esta devolución de llamada, los juegos deben analizar el inviteUri que reciben y determinar el XUID del usuario que recibe esa invitación. En ese momento, es posible que el juego quiera obtener un XUserHandle para la persona que recibe la invitación. El siguiente código muestra cómo funciona esto.

Requisitos

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

Consulte también

XUser
XUserCloseHandle
Última modificación el 28 de agosto de 2026