Skip to main content

XUserGamertagComponent

Especifica el tipo (o componente) de gamertag que se va a capturar.

Sintaxis

Constantes

Comentarios

El límite de longitud y el tamaño del búfer de cada componente del gamertag son los siguientes.
  • Gamertag clásico (XUserGamertagComponent::Classic)
    • Longitud máxima de 15 caracteres, más un terminador nulo. Los gamertags clásicos siempre han estado limitados a 15 caracteres.
    • El tamaño máximo del búfer es de 16 bytes, incluido el espacio para el terminador nulo; (15 caracteres US-ASCII) + (terminador nulo de 1 byte) = 16 bytes.
  • Gamertag moderno (XUserGamertagComponent::Modern)
    • Longitud máxima de 12 caracteres, con cada carácter limitado a tener como máximo 1 signo diacrítico, más un terminador nulo.
    • Si el usuario no ha establecido un gamertag moderno, es idéntico a XUserGamertagComponent::Classic.
    • El tamaño máximo del búfer es de 97 bytes, incluido el espacio para el terminador nulo; (12 caracteres + 12 signos diacríticos) * (4 bytes/carácter) + (terminador nulo de 1 byte) = 97 bytes.
  • Sufijo (XUserGamertagComponent::ModernSuffix)
    • Longitud máxima de 14 caracteres (sin signos diacríticos), más un terminador nulo.
    • Los gamertags clásicos no tienen sufijo (solo el terminador nulo).
    • El tamaño máximo del búfer es de 15 bytes, incluido el espacio para el terminador nulo; (14 caracteres ASCII numéricos) + (terminador nulo de 1 byte) = 15 bytes.
    • Para los gamertags modernos de 11 caracteres o menos, normalmente se asignan sufijos de 4 dígitos. Si ese espacio de 4 dígitos se llena, el número de caracteres aumenta, hasta el número máximo de caracteres posible para que siga cabiendo dentro del límite de longitud total de 16 caracteres del gamertag moderno único.
  • Gamertag moderno único (XUserGamertagComponent::UniqueModern)
    • Contiene el gamertag moderno + ’#’ + el sufijo moderno, o bien el gamertag clásico sin ’#’ y sin sufijo.
    • Longitud máxima de 16 caracteres, más un terminador nulo.
    • El tamaño máximo del búfer es de 101 bytes, incluido el espacio para el terminador nulo; (12 caracteres + 12 signos diacríticos) * (4 bytes/carácter) + ’#’ (1 byte) + (3 caracteres US-ASCII numéricos) + terminador nulo (1 byte) = 101 bytes.
    • El límite de 16 caracteres para un gamertag moderno único significa que un gamertag moderno de 12 caracteres está limitado a un sufijo de 3 dígitos, lo que suma un total de 16 caracteres representados debido al carácter ’#’.
    • A medida que disminuye el número de caracteres del gamertag moderno, el número de caracteres del sufijo puede aumentar, pero el recuento total máximo de bytes del gamertag moderno único nunca superará este valor.

Requisitos

Encabezado: XUser.h Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

XUser XUserGetGamertag Gamertags modernos
Última modificación el 28 de agosto de 2026