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

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

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

## Comentarios

Para recuperar el identificador de usuario de un usuario específico, llame a [XUserGetId](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetid.md).

Para recuperar el estado de un usuario específico, llame a [XUserGetState](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetstate.md).

Para recuperar el grupo de edad de un usuario específico, llame a [XUserGetAgeGroup](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetagegroup.md).

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

[XUserGetId](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetid.md)

[XUserGetState](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetstate.md)

[XUserGetAgeGroup](https://docs.xbox.com/es/reference/system/xuser/functions/xusergetagegroup.md)


## Related topics

- [XUserGamertagComponent](https://docs.xbox.com/es/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Procedimientos recomendados y pruebas para gamertags modernos](https://docs.xbox.com/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Información general sobre gamertags](https://docs.xbox.com/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Requisitos de XBOX probados en la certificación para juegos de XBOX](https://docs.xbox.com/es/publishing/certification/console-cert-tested-requirements.md)
- [Requisitos de XBOX para juegos de XBOX](https://docs.xbox.com/es/publishing/certification/xbox-requirements.md)