Skip to main content

XUserAddResult

Recupera un identificador de un usuario que crea XUserAddAsync.

Sintaxis

Parámetros

async   _Inout_
Tipo: XAsyncBlock*
El bloque asincrónico enviado a XUserAddAsync. newUser   _Out_
Tipo: XUserHandle*
Contiene un identificador del nuevo usuario.

Valor devuelto

Tipo: HRESULT Código de error o de operación correcta HRESULT.

Comentarios

XUserAddAsync inicia una operación asincrónica para agregar un usuario al juego. Use XUserAddResult para recuperar los resultados de la operación. XUserAddAsync siempre muestra una interfaz de usuario del selector de cuentas a menos que pase XUserAddOptions::AddDefaultUserSilently al parámetro options. Si usa XUserAddOptions::AddDefaultUserSilently, XUserAddAsync no muestra ninguna interfaz de usuario. El usuario que devuelve XUserAddOptions::AddDefaultUserSilently se sigue devolviendo hasta que el usuario cierra sesión. Si no hay disponible un usuario predeterminado, XUserAddResult devuelve E_GAMEUSER_NO_DEFAULT_USER. Esto indica que debe llamar a XUserAddAsync sin XUserAddOptions::AddDefaultUserSilently para seleccionar un usuario. Si un usuario tiene prohibido el acceso a XBOX Live, el juego no podrá obtener un XUserHandle para ese usuario. Si se usa XUserAddOptions::AddDefaultUserSilently y el juego fue iniciado por un usuario con prohibición, XUserAddResult devolverá E_GAMEUSER_NO_DEFAULT_USER. De lo contrario, si se muestra la interfaz de usuario, un usuario sin prohibición deberá iniciar sesión, o bien el usuario deberá cancelar la interfaz de usuario y XUserAddResult devolverá E_ABORT. No puede usar XUserAddOptions::AllowGuests con XUserAddOptions::AddDefaultUserSilently. Un invitado no puede ser el usuario predeterminado. Puede usar XUserAddOptions::AllowGuests de forma segura independientemente de si la plataforma actual admite invitados. Debe cerrar cada identificador XUserHandle que recupere de una API de XUsers una vez llamando a XUserCloseHandle. El siguiente ejemplo muestra cómo agregar de forma asincrónica un usuario a una sesión de juego.

Requisitos

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

Documentación conceptual

Consulte también

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