Partager via


XblUserProfile

Represents a user's Xbox Live profile.

Syntax

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  

Members

xboxUserId
Type: uint64_t

The user's Xbox user ID.

appDisplayName
Type: char[XBL_DISPLAY_NAME_CHAR_SIZE]

The UTF-8 encoded user's display name to be used in application UI. This value is privacy gated and could be a user's real name or their Gamertag.

appDisplayPictureResizeUri
Type: char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

UTF-8 encoded Uri for the user's display picture to be used in application UI. The Uri is a resizable Uri. It can be used to specify one of the following sizes and formats by appending '&format={format}&w={width}&h={height}:
Format: png
Width Height
64 64
208 208
424 424

gameDisplayName
Type: char[XBL_DISPLAY_NAME_CHAR_SIZE]

The UTF-8 encoded user's display name to be used in game UI. This value is privacy gated and could be a user's real name or their Gamertag.

gameDisplayPictureResizeUri
Type: char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

UTF-8 encoded Uri for the user's display picture to be used in games. The Uri is a resizable Uri. It can be used to specify one of the following sizes and formats by appending '&format={format}&w={width}&h={height}:
Format: png
Width Height
64 64
208 208
424 424

gamerscore
Type: char[XBL_GAMERSCORE_CHAR_SIZE]

The UTF-8 encoded user's Gamerscore.

gamertag
Type: char[XBL_GAMERTAG_CHAR_SIZE]

The UTF-8 encoded user's Gamertag.

modernGamertag
Type: char[XBL_MODERN_GAMERTAG_CHAR_SIZE]

The UTF-8 encoded modern gamertag for the user. Not guaranteed to be unique.

modernGamertagSuffix
Type: char[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE]

The UTF-8 encoded suffix appended to modern gamertag to ensure uniqueness. May be empty in some cases.

uniqueModernGamertag
Type: char[XBL_UNIQUE_MODERN_GAMERTAG_CHAR_SIZE]

The UTF-8 encoded unique modern gamertag and suffix. Format will be "modernGamertag#suffix". Guaranteed to be no more than 16 rendered characters.

Argument of

XblProfileGetUserProfileResult
XblProfileGetUserProfilesResult
XblProfileGetUserProfilesForSocialGroupResult

Requirements

Header: profile_c.h

See also

profile_c