> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUser (contenido de la API)

> XUser

# XUser

Material de referencia para las API de XUser.

## Funciones

| Función | Descripción |
| - | - |
| [XUserAddAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuseraddasync.md) | Agrega de forma asincrónica un usuario a una sesión de juego. |
| [XUserAddByIdWithUiAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuseraddbyidwithuiasync.md) | 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](https://docs.xbox.com/es/reference/system/xuser/functions/xuseraddbyidwithuiresult.md) | Recupera un identificador del usuario que crea XUserAddByIdWithUiAsync. Esta función solo debe usarse en respuesta a una invitación de juego. |
| [XUserAddResult](https://docs.xbox.com/es/reference/system/xuser/functions/xuseraddresult.md) | Recupera un identificador de un usuario que crea XUserAddAsync. |
| [XUserChangeEventCallback](https://docs.xbox.com/es/reference/system/xuser/functions/xuserchangeeventcallback.md) | Una devolución de llamada que una aplicación define para un evento de cambio de usuario. |
| [XUserCheckPrivilege](https://docs.xbox.com/es/reference/system/xuser/functions/xusercheckprivilege.md) | Determina si un usuario tiene un privilegio específico. |
| [XUserCloseHandle](https://docs.xbox.com/es/reference/system/xuser/functions/xuserclosehandle.md) | Cierra un identificador de usuario específico. |
| [XUserCloseSignOutDeferralHandle](https://docs.xbox.com/es/reference/system/xuser/functions/xuserclosesignoutdeferralhandle.md) | Cierra un identificador específico de aplazamiento de cierre de sesión de usuario. |
| [XUserCompare](https://docs.xbox.com/es/reference/system/xuser/functions/xusercompare.md) | Compara dos identificadores de usuario para comprobar la igualdad. |
| [XUserDefaultAudioEndpointUtf16ChangedCallback](https://docs.xbox.com/es/reference/system/xuser/functions/xuserdefaultaudioendpointutf16changedcallback.md) | 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](https://docs.xbox.com/es/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md) | Una devolución de llamada que se invoca cuando cambia la asociación usuario-dispositivo. |
| [XUserDuplicateHandle](https://docs.xbox.com/es/reference/system/xuser/functions/xuserduplicatehandle.md) | Duplica un identificador de usuario. |
| [XUserFindControllerForUserWithUiAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiasync.md) | Muestra un cuadro de diálogo que pedirá al usuario que encienda e identifique el mando que quiere usar. |
| [XUserFindControllerForUserWithUiResult](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfindcontrollerforuserwithuiresult.md) | Recupera el identificador de dispositivo local de la aplicación (APP\_LOCAL\_DEVICE\_ID) que un usuario ha elegido usar. |
| [XUserFindForDevice](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfindfordevice.md) | Recupera el identificador de usuario para un identificador de dispositivo específico. |
| [XUserFindUserById](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbyid.md) | Recupera el identificador de usuario de XBox (XUID) para un usuario local. |
| [XUserFindUserByLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xuserfinduserbylocalid.md) | Recupera un identificador del usuario para un identificador de usuario local específico. |
| [XUserGetAgeGroup](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetagegroup.md) | Devuelve el grupo de edad de un usuario. |
| [XUserGetDefaultAudioEndpointUtf16](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetdefaultaudioendpointutf16.md) | Recupera el punto de conexión de audio predeterminado para un usuario específico. |
| [XUserGetGamerPictureAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetgamerpictureasync.md) | Recupera de forma asincrónica la imagen de jugador para un usuario específico. |
| [XUserGetGamerPictureResult](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetgamerpictureresult.md) | Recupera el resultado de una llamada a XUserGetGamerPictureAsync. |
| [XUserGetGamerPictureResultSize](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetgamerpictureresultsize.md) | Devuelve el tamaño del búfer que [XUserGetGamerPictureResult](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetgamerpictureresult.md) requiere para recuperar la imagen de jugador que ]XUserGetGamerPictureAsync]\(/es/reference/system/xuser/functions/xusergetgamerpictureasync) devuelve. |
| [XUserGetGamertag](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetgamertag.md) | Recupera el gamertag para un usuario específico. |
| [XUserGetId](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetid.md) | Obtiene el identificador de usuario para un usuario específico. |
| [XUserGetIsGuest](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetisguest.md) | Devuelve un valor booleano que indica si un usuario es un invitado. |
| [XUserGetLocalId](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetlocalid.md) | Recupera un identificador de sesión de juego único para un usuario. |
| [XUserGetMaxUsers](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetmaxusers.md) | Recupera el número máximo de usuarios que permite una sesión de juego en la plataforma actual. |
| [XUserGetMsaTokenSilentlyAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetmsatokensilentlyasync.md) | Esta función está ahora en desuso. |
| [XUserGetMsaTokenSilentlyResult](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetmsatokensilentlyresult.md) | Esta función está ahora en desuso. |
| [XUserGetMsaTokenSilentlyResultSize](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetmsatokensilentlyresultsize.md) | Esta función está ahora en desuso. |
| [XUserGetSignOutDeferral](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetsignoutdeferral.md) | Recupera un identificador del aplazamiento de cierre de sesión. |
| [XUserGetState](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetstate.md) | Recupera el estado de un usuario. |
| [XUserGetTokenAndSignatureAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureasync.md) | Recupera de forma asincrónica xtokens y firmas para solicitudes web. |
| [XUserGetTokenAndSignatureResult](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureresult.md) | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureResultSize](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureresultsize.md) | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureAsync. |
| [XUserGetTokenAndSignatureUtf16Async](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16async.md) | Recupera de forma asincrónica xtokens y firmas Unicode para solicitudes web. |
| [XUserGetTokenAndSignatureUtf16Result](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md) | Obtiene el resultado de una llamada a XUserGetTokenAndSignatureUtf16Async. |
| [XUserGetTokenAndSignatureUtf16ResultSize](https://docs.xbox.com/es/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md) | Obtiene el tamaño del búfer para contener los resultados de una llamada a XUserGetTokenAndSignatureUtf16Async. |
| [XUserIsStoreUser](https://docs.xbox.com/es/reference/system/xuser/functions/xuserisstoreuser.md) | Comprueba si la MSA de XUser es la misma que la MSA con la que se ha iniciado sesión en Microsoft Store. |
| [XUserRegisterForChangeEvent](https://docs.xbox.com/es/reference/system/xuser/functions/xuserregisterforchangeevent.md) | Registra una devolución de llamada para un evento de cambio de usuario. |
| [XUserRegisterForDefaultAudioEndpointUtf16Changed](https://docs.xbox.com/es/reference/system/xuser/functions/xuserregisterfordefaultaudioendpointutf16changed.md) | Registra una devolución de llamada que la aplicación define e invoca cuando cambia el punto de conexión de audio predeterminado. |
| [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/es/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) | Registra una devolución de llamada para los eventos de cambio de asociación de dispositivos de usuario. |
| [XUserResolveIssueWithUiAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL no Unicode. |
| [XUserResolveIssueWithUiResult](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveissuewithuiresult.md) | Recupera el resultado de una llamada a XUserResolveIssueWithUiAsync. |
| [XUserResolveIssueWithUiUtf16Async](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveissuewithuiutf16async.md) | Muestra una interfaz de usuario del sistema para resolver problemas de token con una URL Unicode específica. |
| [XUserResolveIssueWithUiUtf16Result](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveissuewithuiutf16result.md) | Recupera el resultado de una llamada a XUserResolveIssueWithUiUtf16Async. |
| [XUserResolvePrivilegeWithUiAsync](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveprivilegewithuiasync.md) | Muestra una interfaz de usuario de resolución para los privilegios de usuario requeridos. |
| [XUserResolvePrivilegeWithUiResult](https://docs.xbox.com/es/reference/system/xuser/functions/xuserresolveprivilegewithuiresult.md) | Recupera el resultado de una llamada a XUserResolvePrivilegeWithUiAsync. |
| [XUserUnregisterForChangeEvent](https://docs.xbox.com/es/reference/system/xuser/functions/xuserunregisterforchangeevent.md) | Anula el registro de una devolución de llamada de cambio de usuario registrada previamente. |
| [XUserUnregisterForDefaultAudioEndpointUtf16Changed](https://docs.xbox.com/es/reference/system/xuser/functions/xuserunregisterfordefaultaudioendpointutf16changed.md) | Anula el registro de una devolución de llamada de cambio de punto de conexión de audio predeterminado registrada previamente. |
| [XUserUnregisterForDeviceAssociationChanged](https://docs.xbox.com/es/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged.md) | Anula el registro de una devolución de llamada de cambio de asociación de dispositivos de usuario registrada previamente. |
| [xUserPlatformRemoteConnectSetEventHandlers](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformremoteconnectseteventhandlers.md) | Establece los controladores de eventos de conexión remota |
| [XUserPlatformRemoteConnectCancelPrompt](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformremoteconnectcancelprompt.md) | Señal a XUser de que el usuario ha descartado el mensaje de conexión remota. |
| [XUserPlatformRemoteConnectShowPromptEventHandler](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformremoteconnectshowprompteventhandler.md) | Controlador de eventos para mostrar el mensaje de autenticación de conexión remota. |
| [XUserPlatformRemoteConnectClosePromptEventHandler](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformremoteconnectcloseprompteventhandler.md) | Controlador de eventos para cerrar el mensaje de autenticación remota. |
| [XUserPlatformSpopPromptEventHandler](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformspopprompteventhandler.md) | Controlador de eventos para mostrar el mensaje de la operación SPOP |
| [XUserPlatformSpopPromptSetEventHandlers](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformspoppromptseteventhandlers.md) | Establece el controlador de eventos del mensaje de SPOP. |
| [XUserPlatformSpopPromptClearEventHandler](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformspoppromptcleareventhandler.md) | Borra el controlador de eventos del mensaje de SPOP en XUser. |
| [XUserPlatformSpopPromptComplete](https://docs.xbox.com/es/reference/system/xuser/functions/xuserplatformspoppromptcomplete.md) | 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](https://docs.xbox.com/es/reference/system/xuser/structs/app_local_device_id.md) | Especifica el identificador raíz de un dispositivo de entrada local. |
| [XUserDeviceAssociationChange](https://docs.xbox.com/es/reference/system/xuser/structs/xuserdeviceassociationchange.md) | Especifica las asociaciones de dispositivo antigua y nueva cuando cambia una asociación de dispositivo. |
| [XUserGetTokenAndSignatureData](https://docs.xbox.com/es/reference/system/xuser/structs/xusergettokenandsignaturedata.md) | Especifica los xtokens y las firmas que recuperamos para las solicitudes web. |
| [XUserGetTokenAndSignatureHttpHeader](https://docs.xbox.com/es/reference/system/xuser/structs/xusergettokenandsignaturehttpheader.md) | Especifica el encabezado HTTP para una solicitud web. |
| [XUserGetTokenAndSignatureUtf16Data](https://docs.xbox.com/es/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md) | Contiene xtokens y firmas Unicode para solicitudes web. |
| [XUserGetTokenAndSignatureUtf16HttpHeader](https://docs.xbox.com/es/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md) | Contiene un encabezado HTTP Unicode para una solicitud web. |
| [XUserLocalId](https://docs.xbox.com/es/reference/system/xuser/structs/xuserlocalid.md) | Especifica un identificador de sesión de juego para un usuario. |
| [XUserPlatformRemoteConnectEventHandlers](https://docs.xbox.com/es/reference/system/xuser/structs/xuserplatformremoteconnecteventhandlers.md) | Encapsula los controladores de eventos de conexión remota |

## Enumeraciones

| Enumeración | Descripción |
| - | - |
| [XUserAddOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xuseraddoptions.md) | Especifica las opciones para agregar un usuario. |
| [XUserAgeGroup](https://docs.xbox.com/es/reference/system/xuser/enums/xuseragegroup.md) | Especifica el grupo de edad de un usuario. |
| [XUserChangeEvent](https://docs.xbox.com/es/reference/system/xuser/enums/xuserchangeevent.md) | Especifica el tipo de evento de cambio de usuario. |
| [XUserDefaultAudioEndpointKind](https://docs.xbox.com/es/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md) | Especifica si el punto de conexión de audio predeterminado del usuario renderiza o captura audio. |
| [XUserGamerPictureSize](https://docs.xbox.com/es/reference/system/xuser/enums/xusergamerpicturesize.md) | Especifica el tamaño de la imagen de jugador en píxeles. |
| [XUserGamertagComponent](https://docs.xbox.com/es/reference/system/xuser/enums/xusergamertagcomponent.md) | Especifica el tipo (o componente) de gamertag que se va a capturar. |
| [XUserGetMsaTokenSilentlyOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xusergetmsatokensilentlyoptions.md) | Opciones para XUserGetMsaTokenSilentlyOptions. |
| [XUserGetTokenAndSignatureOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xusergettokenandsignatureoptions.md) | Opciones para GetUserTokenAndSignatureAsync. |
| [XUserPrivilege](https://docs.xbox.com/es/reference/system/xuser/enums/xuserprivilege.md) | Especifica los privilegios de un usuario. |
| [XUserPrivilegeDenyReason](https://docs.xbox.com/es/reference/system/xuser/enums/xuserprivilegedenyreason.md) | Especifica el motivo por el que un usuario no pudo obtener un privilegio. |
| [XUserPrivilegeOptions](https://docs.xbox.com/es/reference/system/xuser/enums/xuserprivilegeoptions.md) | Especifica las opciones de privilegios de usuario. |
| [XUserState](https://docs.xbox.com/es/reference/system/xuser/enums/xuserstate.md) | Especifica el estado actual del usuario. |
| [XUserPlatformOperationResult](https://docs.xbox.com/es/reference/system/xuser/enums/XUserPlatformOperationResult.md) | Enumeración que define los resultados de una operación de cliente |
| [XUserPlatformSpopOperationResult](https://docs.xbox.com/es/reference/system/xuser/enums/xuserplatformspopoperationresult.md) | 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](https://docs.xbox.com/es/build/core-features/common/async/async-whitepaper.md)
* [Información general de WinHTTP](https://docs.xbox.com/es/build/console-features/networking/web-requests/intro-winhttp.md)
* [Solicitudes web (contenido)](https://docs.xbox.com/es/build/console-features/networking/web-requests/web-requests-toc.md)
* [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](https://docs.xbox.com/es/build/gdk-and-engines/unity/unity-api-wrappers.md)

## Consulte también

[Referencia de API del sistema](https://docs.xbox.com/es/reference/system/gc-reference-system-toc.md)

## 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](https://docs.xbox.com/es/reference/errorcodes.md).

| 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

- [XtfUser (contenido de la API)](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/xtfuser-xbox-windows-n.md)
- [Interfaz IXtfUserClient (contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [XStore (contenido de la API)](https://docs.xbox.com/es/reference/system/xstore/xstore_members.md)
- [XAppCapture (contenido de la API)](https://docs.xbox.com/es/reference/system/xappcapture/xappcapture_members.md)
- [XPersistentLocalStorage (contenido de la API)](https://docs.xbox.com/es/reference/system/xpersistentlocalstorage/xpersistentlocalstorage_members.md)