XUserGetGamertag

Recupera el gamertag de un usuario específico.

Sintaxis

HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  

Parámetros

user   _In_
Tipo: XUserHandle Un identificador al usuario del que se recupera el gamertag. gamertagComponent   _In_
Tipo: XUserGamertagComponent Tipo de gamertag que se va a recuperar. gamertagSize   _In_
Tipo: size_t Tamaño en bytes del búfer del parámetro gamertag. gamertag   _Out_writes_bytes_to_(gamertagSize,gamertagUsed)
Tipo: char Contiene el gamertag de un usuario específico. gamertagUsed   _Out_opt_
Tipo: size_t* Contiene la cantidad del búfer usada para contener el gamertag.

Valor devuelto

Tipo: HRESULT Código de éxito o de error HRESULT.

Código de retorno	Descripción
S_OK	La operación se realizó correctamente.
E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED	El usuario debe usar una interfaz de usuario para resolver el problema. Llame a XUserResolveIssueWithUiAsync para mostrar la interfaz de usuario al usuario.
E_INSUFFICIENT_BUFFER	El tamaño del búfer indicado por gamertagSize no es lo suficientemente grande como para contener el componente solicitado.
E_INVALIDARG	Se proporcionó un gamertagComponent no válido.

Para obtener una lista de los códigos de error, consulte Códigos de error.

Comentarios

Para recuperar el identificador de usuario de un usuario específico, llame a XUserGetId. Para recuperar el estado de un usuario específico, llame a XUserGetState. Para recuperar el grupo de edad de un usuario específico, llame a XUserGetAgeGroup.

Requisitos

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

Consulte también

XUser XUserGetId XUserGetState XUserGetAgeGroup

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XUserGetGamertag

XUserGetGamertag

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también

​XUserGetGamertag

​Sintaxis

​Parámetros

​Valor devuelto

​Comentarios

​Requisitos

​Consulte también

XUserGetGamertag

Sintaxis

Parámetros

Valor devuelto

Comentarios

Requisitos

Consulte también