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

# XblUserProfile

> XblUserProfile

# XblUserProfile

ユーザーの XBOX Live プロファイルを表します。

## 構文

```cpp theme={null}
typedef struct XblUserProfile {  
    uint64_t xboxUserId;  
    char appDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char appDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    char gameDisplayName[XBL_DISPLAY_NAME_CHAR_SIZE];  
    char gameDisplayPictureResizeUri[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE];  
    char gamerscore[XBL_GAMERSCORE_CHAR_SIZE];  
    char gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    char modernGamertag[XBL_MODERN_GAMERTAG_CHAR_SIZE];  
    char modernGamertagSuffix[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE];  
    char uniqueModernGamertag[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE];  
} XblUserProfile  
```

### メンバー

*xboxUserId*\
型: uint64\_t

ユーザーの XBOX ユーザー ID。

*appDisplayName*\
型: char\[XBL\_DISPLAY\_NAME\_CHAR\_SIZE]

アプリケーション UI で使用される、UTF-8 エンコードされたユーザーの表示名。常にユーザーのゲーマータグとなり、gameDisplayName フィールドと同一です。

*appDisplayPictureResizeUri*\
型: char\[XBL\_DISPLAY\_PIC\_URL\_RAW\_CHAR\_SIZE]

ユーザーのゲーマー画像用の UTF-8 エンコードされた Uri。これは常に gameDisplayPictureResizeUri フィールドと同一です。この Uri はサイズ変更可能な Uri です。'\&format={format}\&w={width}\&h={height}' を追加することで、以下のいずれかのサイズと形式を指定できます:\
 形式: png\
 幅 高さ\
 64 64\
 208 208\
 424 424\


*gameDisplayName*\
型: char\[XBL\_DISPLAY\_NAME\_CHAR\_SIZE]

アプリケーション UI で使用される、UTF-8 エンコードされたユーザーの表示名。常にユーザーのゲーマータグとなり、appDisplayName フィールドと同一です。

*gameDisplayPictureResizeUri*\
型: char\[XBL\_DISPLAY\_PIC\_URL\_RAW\_CHAR\_SIZE]

ユーザーのゲーマー画像用の UTF-8 エンコードされた Uri。これは常に appDisplayPictureResizeUri フィールドと同一です。この Uri はサイズ変更可能な Uri です。'\&format={format}\&w={width}\&h={height}' を追加することで、以下のいずれかのサイズと形式を指定できます:\
 形式: png\
 幅 高さ\
 64 64\
 208 208\
 424 424\


*gamerscore*\
型: char\[XBL\_GAMERSCORE\_CHAR\_SIZE]

UTF-8 エンコードされたユーザーのゲーマースコア。

*gamertag*\
型: char\[XBL\_GAMERTAG\_CHAR\_SIZE]

UTF-8 エンコードされたユーザーのクラシック ゲーマータグ。このフィールドは ASCII 文字のみを使用し、サフィックスを含みません。

*modernGamertag*\
型: char\[XBL\_MODERN\_GAMERTAG\_CHAR\_SIZE]

ユーザー向けの UTF-8 エンコードされたモダン ゲーマータグ。このフィールドは特定範囲の UTF-8 文字を使用し、サフィックスを含みません。一意であることは保証されません。

*modernGamertagSuffix*\
型: char\[XBL\_MODERN\_GAMERTAG\_SUFFIX\_CHAR\_SIZE]

一意性を保証するためにモダン ゲーマータグに付加される UTF-8 エンコードされた数値サフィックス。場合によっては空になることがあります。

*uniqueModernGamertag*\
型: char\[XBL\_UNIQUE\_MODERN\_GAMERTAG\_CHAR\_SIZE]

UTF-8 エンコードされた一意のモダン ゲーマータグと数値サフィックス。形式は "modernGamertag#suffix" となります。レンダリングされた文字数は最大 16 文字であることが保証されます。

## 使用される引数

[XblProfileGetUserProfileResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)\
[XblProfileGetUserProfilesResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult.md)\
[XblProfileGetUserProfilesForSocialGroupResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)

## 要件

**ヘッダー:** profile\_c.h

## 関連項目

[profile\_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/profile_c_members.md)


## Related topics

- [XblProfileGetUserProfileResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)
- [profile_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/profile_c_members.md)
- [XblProfileGetUserProfilesResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult.md)
- [XblProfileGetUserProfilesForSocialGroupResult](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [モダン ゲーマータグのベスト プラクティスとテスト](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)