> ## 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 個字元。

  * 緩衝區大小上限為 16 個位元組，包含 Null 結束字元的空間；(15 個 US-ASCII 字元) + (1 位元組 Null 結束字元) = 16 個位元組。

* **新式玩家代號** (`XUserGamertagComponent::Modern`)

  * 長度上限為 12 個字元，每個字元最多只能有 1 個變音符號，外加一個 Null 結束字元。

  * 如果使用者未設定新式玩家代號，則此值與 `XUserGamertagComponent::Classic` 相同。

  * 緩衝區大小上限為 97 個位元組，包含 Null 結束字元的空間；(12 個字元 + 12 個變音符號) \* (4 位元組/字元) + (1 位元組 Null 結束字元) = 97 個位元組。

* **尾碼** (`XUserGamertagComponent::ModernSuffix`)

  * 長度上限為 14 個字元 (不含變音符號)，外加一個 Null 結束字元。

  * 傳統玩家代號沒有尾碼 (只有 Null 結束字元)。

  * 緩衝區大小上限為 15 個位元組，包含 Null 結束字元的空間；(14 個數字 ASCII 字元) + (1 位元組 Null 結束字元) = 15 個位元組。

  * 對於 11 個字元以下的新式玩家代號，通常會指派 4 位數的尾碼。
    如果 4 位數的空間已用完，字元數會增加，最多可達到仍能符合唯一新式玩家代號總長度 16 個字元限制的字元數上限。

* **唯一新式玩家代號** (`XUserGamertagComponent::UniqueModern`)

  * 包含新式玩家代號 + '#' + 新式尾碼，或是不含 '#' 與尾碼的傳統玩家代號。

  * 長度上限為 16 個字元，外加一個 Null 結束字元。

  * 緩衝區大小上限為 101 個位元組，包含 Null 結束字元的空間；(12 個字元 + 12 個變音符號) \* (4 位元組/字元) + '#' (1 位元組) + (3 個數字 US-ASCII 字元) + Null 結束字元 (1 位元組) = 101 個位元組。

  * 唯一新式玩家代號的 16 個字元限制，表示具有 12 個字元的新式玩家代號只能使用 3 位數的尾碼，由於有 '#' 字元，總共會呈現 16 個字元。

  * 隨著新式玩家代號的字元數減少，尾碼字元數可以增加，但唯一新式玩家代號的總位元組數上限永遠不會超過此值。

## 需求

**標頭：** XUser.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XUser](/zh-TW/reference/system/xuser/xuser_members)

[XUserGetGamertag](/zh-TW/reference/system/xuser/functions/xusergetgamertag)

[新式玩家代號](/zh-TW/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)