Skip to main content

XUserGamertagComponent

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

Sintaxe

Constantes

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 XUserGetGamertag Gamertags modernos
Last modified on October 6, 2026