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

# 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 使用者識別碼。

*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](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult)\
[XblProfileGetUserProfilesResult](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult)\
[XblProfileGetUserProfilesForSocialGroupResult](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult)

## 需求

**標頭：** profile\_c.h

## 另請參閱

[profile\_c](/zh-TW/reference/live/xsapi-c/profile_c/profile_c_members)


## Related topics

- [XblProfileGetUserProfileResult](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)
- [XblProfileGetUserProfilesResult](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult.md)
- [XblProfileGetUserProfilesForSocialGroupResult](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [新式玩家代號的最佳做法和測試](/zh-TW/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XblProfileGetUserProfileAsync](/zh-TW/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileasync.md)