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

# 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](/reference/system/xuser/enums/xusergamertagcomponent)

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

*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](/reference/system/xuser/functions/xuserresolveissuewithuiasync) を呼び出して UI をユーザーに表示してください。 |
| E\_INSUFFICIENT\_BUFFER                     | *gamertagSize* で示されるバッファーのサイズが、要求されたコンポーネントを保持するのに十分ではありません。                                                                                          |
| E\_INVALIDARG                               | 指定された *gamertagComponent* が無効です。                                                                                                                      |

エラー コードの一覧については、[エラー コード](/reference/errorcodes) を参照してください。

## 解説

特定のユーザーのユーザー ID を取得するには、[XUserGetId](/reference/system/xuser/functions/xusergetid) を呼び出します。

特定のユーザーの状態を取得するには、[XUserGetState](/reference/system/xuser/functions/xusergetstate) を呼び出します。

特定のユーザーの年齢グループを取得するには、[XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup) を呼び出します。

## 要件

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

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

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

## 関連項目

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

[XUserGetId](/reference/system/xuser/functions/xusergetid)

[XUserGetState](/reference/system/xuser/functions/xusergetstate)

[XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup)


## Related topics

- [XUserGamertagComponent](/ja-jp/reference/system/xuser/enums/xusergamertagcomponent.md)
- [モダン ゲーマータグのベスト プラクティスとテスト](/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XBOX 認定の概要](/ja-jp/publishing/certification/overview.md)
- [PC およびモバイル ゲーム向けの XBOX 要件テスト ケース](/ja-jp/publishing/certification/pc-policy-tests.md)
- [XR-046 表示名とゲーマー ピクチャ](/ja-jp/publishing/certification/xr/xr-046.md)