Skip to main content

XUserGetGamertag

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

構文

パラメーター

user   _In_
Type: XUserHandle
ゲーマータグを取得する対象のユーザーへのハンドルです。 gamertagComponent   _In_
Type: 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 の成功またはエラー コード。 エラー コードの一覧については、エラー コード を参照してください。

解説

特定のユーザーのユーザー ID を取得するには、XUserGetId を呼び出します。 特定のユーザーの状態を取得するには、XUserGetState を呼び出します。 特定のユーザーの年齢グループを取得するには、XUserGetAgeGroup を呼び出します。

要件

ヘッダー: XUser.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、Steam Deck、XBOX One ファミリ本体および XBOX Series 本体

関連項目

XUser XUserGetId XUserGetState XUserGetAgeGroup
最終更新日 2026年8月24日