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

# XUserGamertagComponent

> XUserGamertagComponent

# XUserGamertagComponent

Especifica o tipo (ou componente) de gamertag a ser buscado.

## Sintaxe

```cpp theme={null}
enum class XUserGamertagComponent  : uint32_t  
{  
    Classic = 0,  
    Modern = 1,  
    ModernSuffix = 2,  
    UniqueModern = 3,  
}  
```

## Constantes

| Constante | Descrição |
| - | - |
| Classic | O gamertag clássico. |
| Modern | Gamertag moderno sem sufixo. |
| ModernSuffix | Sufixo do gamertag moderno, se presente (caso contrário, vazio). |
| UniqueModern | Gamertag moderno com o sufixo para garantir a exclusividade. |

## Comentários

O limite de comprimento e o tamanho do buffer para cada componente do gamertag são os seguintes.

* **Gamertag clássico** (`XUserGamertagComponent::Classic`)

  * Comprimento máximo de 15 caracteres, mais um terminador nulo. Os gamertags clássicos sempre foram limitados a 15 caracteres.

  * O tamanho máximo do buffer é de 16 bytes, incluindo o espaço para o terminador nulo; (15 caracteres US-ASCII) + (terminador nulo de 1 byte) = 16 bytes.

* **Gamertag moderno** (`XUserGamertagComponent::Modern`)

  * Comprimento máximo de 12 caracteres, com cada caractere limitado a no máximo 1 diacrítico, mais um terminador nulo.

  * Se nenhum gamertag moderno for definido pelo usuário, ele será idêntico a `XUserGamertagComponent::Classic`.

  * O tamanho máximo do buffer é de 97 bytes, incluindo o espaço para o terminador nulo; (12 caracteres + 12 diacríticos) \* (4 bytes/caractere) + (terminador nulo de 1 byte) = 97 bytes.

* **Sufixo** (`XUserGamertagComponent::ModernSuffix`)

  * Comprimento máximo de 14 caracteres (sem diacríticos), mais um terminador nulo.

  * Os gamertags clássicos não têm sufixo (apenas o terminador nulo).

  * O tamanho máximo do buffer é de 15 bytes, incluindo o espaço para o terminador nulo; (14 caracteres ASCII numéricos) + (terminador nulo de 1 byte) = 15 bytes.

  * Para gamertags modernos com 11 caracteres ou menos, normalmente são atribuídos sufixos de 4 dígitos.
    Se esse espaço de 4 dígitos se esgotar, o número de caracteres aumentará, até o número máximo de caracteres possível para ainda caber no limite de comprimento total de 16 caracteres do gamertag moderno exclusivo.

* **Gamertag moderno exclusivo** (`XUserGamertagComponent::UniqueModern`)

  * Contém o gamertag moderno + '#' + sufixo moderno, ou o gamertag clássico sem '#' e sem sufixo.

  * Comprimento máximo de 16 caracteres, mais um terminador nulo.

  * O tamanho máximo do buffer é de 101 bytes, incluindo o espaço para o terminador nulo; (12 caracteres + 12 diacríticos) \* (4 bytes/caractere) + '#' (1 byte) + (3 caracteres US-ASCII numéricos) + terminador nulo (1 byte) = 101 bytes.

  * O limite de 16 caracteres para um gamertag moderno exclusivo significa que um gamertag moderno com 12 caracteres é limitado a um sufixo de 3 dígitos, o que totaliza 16 caracteres renderizados por causa do caractere '#'.

  * À medida que o número de caracteres no gamertag moderno diminui, o número de caracteres do sufixo pode aumentar, mas a contagem máxima total de bytes do gamertag moderno exclusivo nunca excederá esse valor.

## Requisitos

**Cabeçalho:** XUser.h

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

## Confira também

[XUser](/pt-BR/reference/system/xuser/xuser_members)

[XUserGetGamertag](/pt-BR/reference/system/xuser/functions/xusergetgamertag)

[Gamertags modernos](/pt-BR/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-toc)


## Related topics

- [XUserGamertagComponent](/reference/system/xuser/enums/xusergamertagcomponent.md)
- [Gamertags overview](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Información general sobre gamertags](/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [Modern gamertags definition and terminology](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-definition.md)
- [Definición y terminología de los gamertags modernos](/es/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-definition.md)