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.
