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 SeriesConsulte también
XUserXUserCloseHandle
