> ## 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.

# XUserGetGamertag

> XUserGetGamertag

# XUserGetGamertag

Recupera el gamertag de un usuario específico.

## Sintaxis

```cpp theme={null}
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](/reference/system/xuser/enums/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](/reference/system/xuser/functions/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](/reference/errorcodes).

## Comentarios

Para recuperar el identificador de usuario de un usuario específico, llame a [XUserGetId](/reference/system/xuser/functions/xusergetid).

Para recuperar el estado de un usuario específico, llame a [XUserGetState](/reference/system/xuser/functions/xusergetstate).

Para recuperar el grupo de edad de un usuario específico, llame a [XUserGetAgeGroup](/reference/system/xuser/functions/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](/reference/system/xuser/xuser_members)

[XUserGetId](/reference/system/xuser/functions/xusergetid)

[XUserGetState](/reference/system/xuser/functions/xusergetstate)

[XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup)


## Related topics

- [XUserGamertagComponent](/es/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Procedimientos recomendados y pruebas para gamertags modernos](/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XR-046 Nombre para mostrar y gamerpic](/es/publishing/certification/xr/xr-046.md)
- [Información general sobre gamertags](/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Información general de la certificación de XBOX](/es/publishing/certification/overview.md)