> ## 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 o gamertag de um usuário específico.

## Sintaxe

```cpp theme={null}
HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  
```

### Parâmetros

*user*   \_In\_\
Tipo: XUserHandle

Um identificador para o usuário cujo gamertag será recuperado.

*gamertagComponent*   \_In\_\
Tipo: [XUserGamertagComponent](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xusergamertagcomponent.md)

Tipo de gamertag a ser recuperado.

*gamertagSize*   \_In\_\
Tipo: size\_t

Tamanho em bytes do buffer no parâmetro *gamertag*.

*gamertag*   \_Out\_writes\_bytes\_to\_(gamertagSize,*gamertagUsed)\
Tipo: char*

Contém o gamertag de um usuário específico.

*gamertagUsed*   \_Out\_opt\_\
Tipo: size\_t\*

Contém a quantidade do buffer usada para armazenar o gamertag.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou erro HRESULT.

| Código de retorno | Descrição |
| - | - |
| S\_OK | A operação foi bem-sucedida. |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | O usuário deve usar uma interface do usuário para resolver o problema. Chame [XUserResolveIssueWithUiAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) para exibir a interface do usuário. |
| E\_INSUFFICIENT\_BUFFER | O tamanho do buffer indicado por *gamertagSize* não é grande o suficiente para conter o componente solicitado. |
| E\_INVALIDARG | *gamertagComponent* inválido fornecido. |

Para obter uma lista de códigos de erro, consulte [Códigos de erro](https://docs.xbox.com/pt-BR/reference/errorcodes.md).

## Comentários

Para recuperar a ID de usuário de um usuário específico, chame [XUserGetId](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetid.md).

Para recuperar o estado de um usuário específico, chame [XUserGetState](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetstate.md).

Para recuperar a faixa etária de um usuário específico, chame [XUserGetAgeGroup](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetagegroup.md).

## Requisitos

**Cabeçalho:** XUser.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, Steam Deck, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XUser](https://docs.xbox.com/pt-BR/reference/system/xuser/xuser_members.md)

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

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

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


## Related topics

- [XUserGamertagComponent](https://docs.xbox.com/pt-BR/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Práticas recomendadas e testes para gamertags modernas](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [Visão geral das gamertags](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Requisitos XBOX testados na certificação para jogos XBOX](https://docs.xbox.com/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [Requisitos do XBOX para jogos do XBOX](https://docs.xbox.com/pt-BR/publishing/certification/xbox-requirements.md)