Skip to main content

XUserAddOptions

Especifica las opciones para agregar un usuario.

Sintaxis

Constantes

Comentarios

Hay algunos casos extremos que los desarrolladores deben conocer si llaman repetidamente a XUserAddAsync con options establecido en XUserAddOptions::AddDefaultUserSilently:
  • Si llama a esta función repetidamente y se conoce el usuario predeterminado que inició el juego, devolverá ese mismo usuario.
  • Si el usuario predeterminado conocido anteriormente ha cerrado sesión y solo hay un usuario con sesión iniciada en el dispositivo, marcará a ese usuario como el nuevo usuario “predeterminado” y lo devolverá.
  • Si el usuario predeterminado conocido anteriormente ha cerrado sesión y hay varios usuarios con sesión iniciada en el dispositivo, devolverá E_GAMEUSER_NO_DEFAULT_USER.
  • En los inicios de desarrollador, el usuario que será el usuario predeterminado es el usuario de inicio de sesión automático, que se puede especificar estableciendo ese usuario como el usuario de inicio de sesión automático en DevHome o mediante xbconfig (tema NDA) DefaultUser.
Si no hay disponible un usuario predeterminado*, XUserAddResult devuelve E_GAMEUSER_NO_DEFAULT_USER. Debe llamar a XUserAddAsync con options no establecido en XUserAddOptions::AddDefaultUserSilently. También hay algunos casos extremos que los desarrolladores deben conocer si llaman repetidamente a XUserAddAsync con options establecido en XUserAddOptions::AddDefaultUserAllowingUI. Son muy similares (pero no idénticos) al caso de interfaz de usuario silenciosa:
  • Si llama a esta función repetidamente y se conoce el usuario predeterminado que inició el juego, devolverá ese mismo usuario.
  • Si el usuario predeterminado conocido anteriormente ha cerrado sesión y solo hay un usuario con sesión iniciada en el dispositivo, marcará a ese usuario como el nuevo usuario “predeterminado” y lo devolverá.
  • Si el usuario que inició inicialmente el juego ha cerrado sesión y el número de usuarios es 0 o más de 1, el sistema mostrará una interfaz de usuario para obtener el usuario y, a continuación, establecerá a ese usuario como el predeterminado.
En XUserAddAsync, no puede usar XUserAddOptions::AllowGuests con XUserAddOptions::AddDefaultUserSilently. Un invitado no puede ser el usuario predeterminado. Puede usar XUserAddOptions::AllowGuests, aunque la plataforma actual no admita invitados. El siguiente ejemplo muestra cómo agregar de forma asincrónica un usuario a una sesión de juego.

Requisitos

Encabezado: XUser.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

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