> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # XUser > XUser # XUser Material de referencia para las API de XUser. ## Funciones | Función | Descripción | | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [XUserAddAsync](/reference/system/xuser/functions/xuseraddasync) | Agrega de forma asincrónica un usuario a una sesión de juego. | | [XUserAddByIdWithUiAsync](/reference/system/xuser/functions/xuseraddbyidwithuiasync) | Agrega de forma asincrónica un usuario a una sesión de juego basándose en un XUID de una invitación de juego. Esta función solo debe usarse en respuesta a una invitación de juego. | | [XUserAddByIdWithUiResult](/reference/system/xuser/functions/xuseraddbyidwithuiresult) | Recupera un identificador del usuario que crea XUserAddByIdWithUiAsync. Esta función solo debe usarse en respuesta a una invitación de juego. | | [XUserAddResult](/reference/system/xuser/functions/xuseraddresult) | Recupera un identificador de un usuario que crea XUserAddAsync. | | [XUserChangeEventCallback](/reference/system/xuser/functions/xuserchangeeventcallback) | Una devolución de llamada que una aplicación define para un evento de cambio de usuario. | | [XUserCheckPrivilege](/reference/system/xuser/functions/xusercheckprivilege) | Determina si un usuario tiene un privilegio específico. | | [XUserCloseHandle](/reference/system/xuser/functions/xuserclosehandle) | Cierra un identificador de usuario específico. | | [XUserCloseSignOutDeferralHandle](/reference/system/xuser/functions/xuserclosesignoutdeferralhandle) | Cierra un identificador específico de aplazamiento de cierre de sesión de usuario. | | [XUserCompare](/reference/system/xuser/functions/xusercompare) | Compara dos identificadores de usuario para comprobar la igualdad. | | [XUserDefaultAudioEndpointUtf16ChangedCallback](/reference/system/xuser/functions/xuserdefaultaudioendpointutf16changedcallback) | Una devolución de llamada que una aplicación define e invoca cuando cambia el punto de conexión de audio predeterminado para un usuario. | | [XUserDeviceAssociationChangedCallback](/reference/system/xuser/functions/xuserdeviceassociationchangedcallback) | Una devolución de llamada que se invoca cuando cambia la asociación usuario-dispositivo. | | [XUserDuplicateHandle](/reference/system/xuser/functions/xuserduplicatehandle) | Duplica un identificador de usuario. | | [XUserFindControllerForUserWithUiAsync](/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync) | Muestra un cuadro de diálogo que pedirá al usuario que encienda e identifique el mando que quiere usar. | | [XUserFindControllerForUserWithUiResult](/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult) | Recupera el identificador de dispositivo local de la aplicación (APP\_LOCAL\_DEVICE\_ID) que un usuario ha elegido usar. | | [XUserFindForDevice](/reference/system/xuser/functions/xuserfindfordevice) | Recupera el identificador de usuario para un identificador de dispositivo específico. | | [XUserFindUserById](/reference/system/xuser/functions/xuserfinduserbyid) | Recupera el identificador de usuario de XBox (XUID) para un usuario local. | | [XUserFindUserByLocalId](/reference/system/xuser/functions/xuserfinduserbylocalid) | Recupera un identificador del usuario para un identificador de usuario local específico. | | [XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup) | Devuelve el grupo de edad de un usuario. | | [XUserGetDefaultAudioEndpointUtf16](/reference/system/xuser/functions/xusergetdefaultaudioendpointutf16) | Recupera el punto de conexión de audio predeterminado para un usuario específico. | | [XUserGetGamerPictureAsync](/reference/system/xuser/functions/xusergetgamerpictureasync) | Recupera de forma asincrónica la imagen de jugador para un usuario específico. | | [XUserGetGamerPictureResult](/reference/system/xuser/functions/xusergetgamerpictureresult) | Recupera el resultado de una llamada a XUserGetGamerPictureAsync. | | [XUserGetGamerPictureResultSize](/reference/system/xuser/functions/xusergetgamerpictureresultsize) | Devuelve el tamaño del búfer que [XUserGetGamerPictureResult](/reference/system/xuser/functions/xusergetgamerpictureresult) requiere para recuperar la imagen de jugador que ]XUserGetGamerPictureAsync]\(/reference/system/xuser/functions/xusergetgamerpictureasync) devuelve. | | [XUserGetGamertag](/reference/system/xuser/functions/xusergetgamertag) | Recupera el gamertag para un usuario específico. | | [XUserGetId](/reference/system/xuser/functions/xusergetid) | Obtiene el identificador de usuario para un usuario específico. | | [XUserGetIsGuest](/reference/system/xuser/functions/xusergetisguest) | Devuelve un valor booleano que indica si un usuario es un invitado. | | [XUserGetLocalId](/reference/system/xuser/functions/xusergetlocalid) | Recupera un identificador de sesión de juego único para un usuario. | | [XUserGetMaxUsers](/reference/system/xuser/functions/xusergetmaxusers) | Recupera el número máximo de usuarios que permite una sesión de juego en la plataforma actual. | | [XUserGetMsaTokenSilentlyAsync](/reference/system/xuser/functions/xusergetmsatokensilentlyasync) | Esta función está ahora en desuso. | | [XUserGetMsaTokenSilentlyResult](/reference/system/xuser/functions/xusergetmsatokensilentlyresult) | Esta función está ahora en desuso. | | [XUserGetMsaTokenSilentlyResultSize](/reference/system/xuser/functions/xusergetmsatokensilentlyresultsize) | Esta función está ahora en desuso. | | [XUserGetSignOutDeferral](/reference/system/xuser/functions/xusergetsignoutdeferral) | Recupera un identificador del aplazamiento de cierre de sesión. | | [XUserGetState](/reference/system/xuser/functions/xusergetstate) | Recupera el estado de un usuario. | | [XUserGetTokenAndSignatureAsync](/reference/system/xuser/functions/xusergettokenandsignatureasync) | Recupera de forma asincrónica xtokens y firmas para solicitudes web. | | [XUserGetTokenAndSignatureResult](/reference/system/xuser/functions/xusergettokenandsignatureresult) | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureAsync. | | [XUserGetTokenAndSignatureResultSize](/reference/system/xuser/functions/xusergettokenandsignatureresultsize) | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureAsync. | | [XUserGetTokenAndSignatureUtf16Async](/reference/system/xuser/functions/xusergettokenandsignatureutf16async) | Recupera de forma asincrónica xtokens y firmas Unicode para solicitudes web. | | [XUserGetTokenAndSignatureUtf16Result](/reference/system/xuser/functions/xusergettokenandsignatureutf16result) | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureUtf16Async. | | [XUserGetTokenAndSignatureUtf16ResultSize](/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize) | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureUtf16Async. | | [XUserIsStoreUser](/reference/system/xuser/functions/xuserisstoreuser) | Comprueba si la MSA de XUser es la misma que la MSA con la que se ha iniciado sesión en Microsoft Store. | | [XUserRegisterForChangeEvent](/reference/system/xuser/functions/xuserregisterforchangeevent) | Registra una devolución de llamada para un evento de cambio de usuario. | | [XUserRegisterForDefaultAudioEndpointUtf16Changed](/reference/system/xuser/functions/xuserregisterfordefaultaudioendpointutf16changed) | Registra una devolución de llamada que la aplicación define e invoca cuando cambia el punto de conexión de audio predeterminado. | | [XUserRegisterForDeviceAssociationChanged](/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged) | Registra una devolución de llamada para los eventos de cambio de asociación de dispositivos de usuario. | | [XUserResolveIssueWithUiAsync](/reference/system/xuser/functions/xuserresolveissuewithuiasync) | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL no Unicode. | | [XUserResolveIssueWithUiResult](/reference/system/xuser/functions/xuserresolveissuewithuiresult) | Recupera el resultado de una llamada a XUserResolveIssueWithUiAsync. | | [XUserResolveIssueWithUiUtf16Async](/reference/system/xuser/functions/xuserresolveissuewithuiutf16async) | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL Unicode específica. | | [XUserResolveIssueWithUiUtf16Result](/reference/system/xuser/functions/xuserresolveissuewithuiutf16result) | Recupera el resultado de una llamada a XUserResolveIssueWithUiUtf16Async. | | [XUserResolvePrivilegeWithUiAsync](/reference/system/xuser/functions/xuserresolveprivilegewithuiasync) | Muestra una interfaz de usuario de resolución para los privilegios de usuario requeridos. | | [XUserResolvePrivilegeWithUiResult](/reference/system/xuser/functions/xuserresolveprivilegewithuiresult) | Recupera el resultado de una llamada a XUserResolvePrivilegeWithUiAsync. | | [XUserUnregisterForChangeEvent](/reference/system/xuser/functions/xuserunregisterforchangeevent) | Anula el registro de una devolución de llamada de cambio de usuario registrada previamente. | | [XUserUnregisterForDefaultAudioEndpointUtf16Changed](/reference/system/xuser/functions/xuserunregisterfordefaultaudioendpointutf16changed) | Anula el registro de una devolución de llamada de cambio de punto de conexión de audio predeterminado registrada previamente. | | [XUserUnregisterForDeviceAssociationChanged](/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged) | Anula el registro de una devolución de llamada de cambio de asociación de dispositivos de usuario registrada previamente. | | [xUserPlatformRemoteConnectSetEventHandlers](/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers) | Establece los controladores de eventos de conexión remota | | [XUserPlatformRemoteConnectCancelPrompt](/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt) | Señal a XUser de que el usuario ha descartado el mensaje de conexión remota. | | [XUserPlatformRemoteConnectShowPromptEventHandler](/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler) | Controlador de eventos para mostrar el mensaje de autenticación de conexión remota. | | [XUserPlatformRemoteConnectClosePromptEventHandler](/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler) | Controlador de eventos para cerrar el mensaje de autenticación remota. | | [XUserPlatformSpopPromptEventHandler](/reference/system/xuser/functions/xuserplatformspopprompteventhandler) | Controlador de eventos para mostrar el mensaje de la operación SPOP | | [XUserPlatformSpopPromptSetEventHandlers](/reference/system/xuser/functions/xuserplatformspoppromptseteventhandlers) | Establece el controlador de eventos del mensaje de SPOP. | | [XUserPlatformSpopPromptClearEventHandler](/reference/system/xuser/functions/xuserplatformspoppromptcleareventhandler) | Borra el controlador de eventos del mensaje de SPOP en XUser. | | [XUserPlatformSpopPromptComplete](/reference/system/xuser/functions/xuserplatformspoppromptcomplete) | Señal a XUser de que el usuario ha terminado de interactuar con el mensaje de SPOP. | ## Estructuras | Estructura | Descripción | | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | | [APP\_LOCAL\_DEVICE\_ID](/reference/system/xuser/structs/app_local_device_id) | Especifica el identificador raíz de un dispositivo de entrada local. | | [XUserDeviceAssociationChange](/reference/system/xuser/structs/xuserdeviceassociationchange) | Especifica las asociaciones de dispositivo antigua y nueva cuando cambia una asociación de dispositivo. | | [XUserGetTokenAndSignatureData](/reference/system/xuser/structs/xusergettokenandsignaturedata) | Especifica los xtokens y las firmas que recuperamos para las solicitudes web. | | [XUserGetTokenAndSignatureHttpHeader](/reference/system/xuser/structs/xusergettokenandsignaturehttpheader) | Especifica el encabezado HTTP para una solicitud web. | | [XUserGetTokenAndSignatureUtf16Data](/reference/system/xuser/structs/xusergettokenandsignatureutf16data) | Contiene xtokens y firmas Unicode para solicitudes web. | | [XUserGetTokenAndSignatureUtf16HttpHeader](/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader) | Contiene un encabezado HTTP Unicode para una solicitud web. | | [XUserLocalId](/reference/system/xuser/structs/xuserlocalid) | Especifica un identificador de sesión de juego para un usuario. | | [XUserPlatformRemoteConnectEventHandlers](/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers) | Encapsula los controladores de eventos de conexión remota | ## Enumeraciones | Enumeración | Descripción | | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | [XUserAddOptions](/reference/system/xuser/enums/xuseraddoptions) | Especifica las opciones para agregar un usuario. | | [XUserAgeGroup](/reference/system/xuser/enums/xuseragegroup) | Especifica el grupo de edad de un usuario. | | [XUserChangeEvent](/reference/system/xuser/enums/xuserchangeevent) | Especifica el tipo de evento de cambio de usuario. | | [XUserDefaultAudioEndpointKind](/reference/system/xuser/enums/xuserdefaultaudioendpointkind) | Especifica si el punto de conexión de audio predeterminado del usuario renderiza o captura audio. | | [XUserGamerPictureSize](/reference/system/xuser/enums/xusergamerpicturesize) | Especifica el tamaño de la imagen de jugador en píxeles. | | [XUserGamertagComponent](/reference/system/xuser/enums/xusergamertagcomponent) | Especifica el tipo (o componente) de gamertag que se va a capturar. | | [XUserGetMsaTokenSilentlyOptions](/reference/system/xuser/enums/xusergetmsatokensilentlyoptions) | Opciones para XUserGetMsaTokenSilentlyOptions. | | [XUserGetTokenAndSignatureOptions](/reference/system/xuser/enums/xusergettokenandsignatureoptions) | Opciones para GetUserTokenAndSignatureAsync. | | [XUserPrivilege](/reference/system/xuser/enums/xuserprivilege) | Especifica los privilegios de un usuario. | | [XUserPrivilegeDenyReason](/reference/system/xuser/enums/xuserprivilegedenyreason) | Especifica el motivo por el que un usuario no pudo obtener un privilegio. | | [XUserPrivilegeOptions](/reference/system/xuser/enums/xuserprivilegeoptions) | Especifica las opciones de privilegios de usuario. | | [XUserState](/reference/system/xuser/enums/xuserstate) | Especifica el estado actual del usuario. | | [XUserPlatformOperationResult](/reference/system/xuser/enums/XUserPlatformOperationResult) | Enumeración que define los resultados de una operación de cliente | | [XUserPlatformSpopOperationResult](/reference/system/xuser/enums/xuserplatformspopoperationresult) | Enumeración que define los resultados de una operación de cliente. | ## Documentación conceptual * [Objetivos de diseño y mejoras de la programación asincrónica](/build/core-features/common/async/async-whitepaper) * [Información general de WinHTTP](/build/console-features/networking/web-requests/intro-winhttp) * [Solicitudes web (contenido)](/build/console-features/networking/web-requests/web-requests-toc) * [Subprocesos con dependencia temporal](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads) * [Uso de contenedores de C# para las API del GDK en su proyecto de Unity](/build/gdk-and-engines/unity/unity-api-wrappers) ## Consulte también [Referencia de API del sistema](/reference/system/gc-reference-system-toc) ## Códigos de error Las API de XUser pueden devolver los siguientes códigos de error. Para obtener una lista completa, consulte [Códigos de error](/reference/errorcodes). | Código | Valor | Descripción | | ------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ | | E\_GAMEUSER\_MAX\_USERS\_ADDED | 0x89245100 | No se puede agregar este usuario porque se ha alcanzado el número máximo de usuarios. | | E\_GAMEUSER\_SIGNED\_OUT | 0x89245101 | No se puede realizar la operación porque el usuario ha cerrado sesión. | | E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 0x89245102 | Se requiere la interfaz de usuario para resolver un problema con este usuario. | | E\_GAMEUSER\_DEFERRAL\_NOT\_AVAILABLE | 0x89245103 | No es un momento apropiado para solicitar un aplazamiento. | | E\_GAMEUSER\_USER\_NOT\_FOUND | 0x89245104 | No se encontró ningún usuario que coincida con el identificador. | | E\_GAMEUSER\_NO\_TOKEN\_REQUIRED | 0x89245105 | No se requiere ningún token para esta llamada. | | E\_GAMEUSER\_NO\_DEFAULT\_USER | 0x89245106 | No hay ningún usuario predeterminado actual. Si obtiene este error, llame a XUserAddAsync de nuevo sin AddDefaultUserSilently. | | E\_GAMEUSER\_FAILED\_TO\_RESOLVE | 0x89245107 | No se pudo resolver el privilegio dado. | | E\_GAMEUSER\_NO\_TITLE\_ID | 0x89245108 | Se debe configurar un TitleId de XBOX Live. | | E\_GAMEUSER\_UNKNOWN\_GAME\_IDENTITY | 0x89245109 | No se reconoce la identidad del juego. El MSAAppId y el TitleId no coinciden con los asociados al juego. | | E\_GAMEUSER\_NO\_PACKAGE\_IDENTITY | 0x89245110 | Se debe configurar una identidad de paquete. | | E\_GAMEUSER\_FAILED\_TO\_GET\_TOKEN | 0x89245111 | Error en la solicitud de token. | | E\_GAMEUSER\_INVALID\_APP\_CONFIGURATION | 0x89245112 | El MSAAppId de la configuración del juego no es válido o no está configurado para la pila de autenticación. | | E\_GAMEUSER\_MALFORMED\_MSAAPPID | 0x89245113 | El MSAAppId de la configuración del juego no coincide con el formato esperado (cadena de 16 caracteres o GUID). | | E\_GAMEUSER\_INCONSISTENT\_MSAAPPID\_AND\_TITLEID | 0x89245114 | El MSAAppId y el TitleId de la configuración del juego no coinciden con los asociados al juego. | ## Related topics - [Identidad de usuario y XUser](/es/build/core-features/common/user/player-identity-xuser.md) - [Automatización desatendida de XUser](/es/build/core-features/common/user/users-headless-automation.md) - [XUserIsStoreUser](/es/reference/system/xuser/functions/xuserisstoreuser.md) - [XUserFindUserById](/es/reference/system/xuser/functions/xuserfinduserbyid.md) - [XUserGetMaxUsers](/es/reference/system/xuser/functions/xusergetmaxusers.md)