> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserGetGamertag

> XUserGetGamertag

# XUserGetGamertag

特定のユーザーのゲーマータグを取得します。

## 構文

```cpp theme={null}
HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  
```

### パラメーター

*user*   \_In\_\
Type: XUserHandle

ゲーマータグを取得する対象のユーザーへのハンドルです。

*gamertagComponent*   \_In\_\
Type: [XUserGamertagComponent](https://docs.xbox.com/ja-jp/reference/system/xuser/enums/xusergamertagcomponent.md)

取得するゲーマータグの種類です。

*gamertagSize*   \_In\_\
Type: size\_t

*gamertag* パラメーターのバッファーのサイズ (バイト単位) です。

*gamertag*   \_Out\_writes\_bytes\_to\_(gamertagSize,*gamertagUsed)\
Type: char*

特定のユーザーのゲーマータグが格納されます。

*gamertagUsed*   \_Out\_opt\_\
Type: size\_t\*

ゲーマータグを保持するためにバッファーで使用された量が格納されます。

### 戻り値

Type: HRESULT

HRESULT の成功またはエラー コード。

| 戻り値コード | 説明 |
| - | - |
| S\_OK | 操作は成功しました。 |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | ユーザーは UI を使用して問題を解決する必要があります。[XUserResolveIssueWithUiAsync](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xuserresolveissuewithuiasync.md) を呼び出して UI をユーザーに表示してください。 |
| E\_INSUFFICIENT\_BUFFER | *gamertagSize* で示されるバッファーのサイズが、要求されたコンポーネントを保持するのに十分ではありません。 |
| E\_INVALIDARG | 指定された *gamertagComponent* が無効です。 |

エラー コードの一覧については、[エラー コード](https://docs.xbox.com/ja-jp/reference/errorcodes.md) を参照してください。

## 解説

特定のユーザーのユーザー ID を取得するには、[XUserGetId](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetid.md) を呼び出します。

特定のユーザーの状態を取得するには、[XUserGetState](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetstate.md) を呼び出します。

特定のユーザーの年齢グループを取得するには、[XUserGetAgeGroup](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetagegroup.md) を呼び出します。

## 要件

**ヘッダー:** XUser.h

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、Steam Deck、XBOX One ファミリ本体および XBOX Series 本体

## 関連項目

[XUser](https://docs.xbox.com/ja-jp/reference/system/xuser/xuser_members.md)

[XUserGetId](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetid.md)

[XUserGetState](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetstate.md)

[XUserGetAgeGroup](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetagegroup.md)


## Related topics

- [XUserGamertagComponent](https://docs.xbox.com/ja-jp/reference/system/xuser/enums/xusergamertagcomponent.md)
- [モダン ゲーマータグのベスト プラクティスとテスト](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [ゲーマータグの概要](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [XUser (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xuser/xuser_members.md)
- [XBOX ゲーム向け認定テスト対象 XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/console-cert-tested-requirements.md)