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

가져올 게이머태그의 유형(또는 구성 요소)을 지정합니다.

## 구문

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

## 상수

| 상수           | 설명                                        |
| ------------ | ----------------------------------------- |
| Classic      | 클래식 게이머태그입니다.                             |
| Modern       | 접미사가 없는 모던 게이머태그입니다.                      |
| ModernSuffix | 존재하는 경우 모던 게이머태그 접미사(그렇지 않은 경우 비어 있음)입니다. |
| UniqueModern | 고유성을 보장하기 위한 접미사가 포함된 모던 게이머태그입니다.        |

## 설명

각 게이머태그 구성 요소의 길이 제한 및 버퍼 크기는 다음과 같습니다.

* **클래식 게이머태그** (`XUserGamertagComponent::Classic`)

  * 최대 길이는 15자이며, null 종결자가 추가됩니다. 클래식 게이머태그는 항상 15자로 제한되어 있습니다.

  * 최대 버퍼 크기는 null 종결자를 포함하여 16바이트입니다. (15개의 US-ASCII 문자) + (1바이트 null 종결자) = 16바이트.

* **모던 게이머태그** (`XUserGamertagComponent::Modern`)

  * 최대 길이는 12자이며, 각 문자당 최대 1개의 발음 구별 기호를 가질 수 있고, null 종결자가 추가됩니다.

  * 사용자가 모던 게이머태그를 설정하지 않은 경우 이는 `XUserGamertagComponent::Classic`과 동일합니다.

  * 최대 버퍼 크기는 null 종결자를 포함하여 97바이트입니다. (12개의 문자 + 12개의 발음 구별 기호) \* (4바이트/문자) + (1바이트 null 종결자) = 97바이트.

* **접미사** (`XUserGamertagComponent::ModernSuffix`)

  * 최대 길이는 14자(발음 구별 기호 없음)이며, null 종결자가 추가됩니다.

  * 클래식 게이머태그는 접미사가 없습니다(null 종결자만 있음).

  * 최대 버퍼 크기는 null 종결자를 포함하여 15바이트입니다. (14개의 숫자 ASCII 문자) + (1바이트 null 종결자) = 15바이트.

  * 11자 이하의 모던 게이머태그의 경우, 일반적으로 4자리 접미사가 할당됩니다.
    해당 4자리 공간이 가득 차면 문자 수가 증가하며, 고유 모던 게이머태그의 총 길이 제한인 16자에 맞도록 가능한 최대 문자 수까지 증가합니다.

* **고유 모던 게이머태그** (`XUserGamertagComponent::UniqueModern`)

  * 모던 게이머태그 + '#' + 모던 접미사, 또는 '#'과 접미사가 없는 클래식 게이머태그를 포함합니다.

  * 최대 길이는 16자이며, null 종결자가 추가됩니다.

  * 최대 버퍼 크기는 null 종결자를 포함하여 101바이트입니다. (12개의 문자 + 12개의 발음 구별 기호) \* (4바이트/문자) + '#' (1바이트) + (3개의 숫자 US-ASCII 문자) + null 종결자 (1바이트) = 101바이트.

  * 고유 모던 게이머태그의 16자 제한은 12자의 모던 게이머태그가 3자리 접미사로 제한됨을 의미하며, '#' 문자로 인해 총 16개의 렌더링된 문자가 됩니다.

  * 모던 게이머태그의 문자 수가 감소함에 따라 접미사 문자 수는 증가할 수 있지만, 고유 모던 게이머태그의 총 최대 바이트 수는 이를 초과하지 않습니다.

## 요구 사항

**헤더:** XUser.h

**지원되는 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XUser](/reference/system/xuser/xuser_members)

[XUserGetGamertag](/reference/system/xuser/functions/xusergetgamertag)

[모던 게이머태그](/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-toc)


## Related topics

- [게이머태그 개요](/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [XUserGetGamertag](/ko/reference/system/xuser/functions/xusergetgamertag.md)
- [모던 게이머태그 정의 및 용어](/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-definition.md)
- [모던 게이머태그의 모범 사례 및 테스트](/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XUser](/ko/reference/system/xuser/xuser_members.md)