Share 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 will always be the user's gamertag and identical to the gameDisplayName field.

appDisplayPictureResizeUri
Type: char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

UTF-8 encoded Uri for the user's gamer pic. This will always be identical to the gameDisplayPictureResizeUri field. 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 application UI. This will always be the user's gamertag and identical to the appDisplayName field.

gameDisplayPictureResizeUri
Type: char[XBL_DISPLAY_PIC_URL_RAW_CHAR_SIZE]

UTF-8 encoded Uri for the user's gamer pic. This will always be identical to the appDisplayPictureResizeUri field. 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 classic gamertag. This field only uses ASCII characters and does not include a suffix.

modernGamertag
Type: char[XBL_MODERN_GAMERTAG_CHAR_SIZE]

The UTF-8 encoded modern gamertag for the user. This field uses specific ranges of UTF-8 characters and does not include a suffix. Not guaranteed to be unique.

modernGamertagSuffix
Type: char[XBL_MODERN_GAMERTAG_SUFFIX_CHAR_SIZE]

The UTF-8 encoded numeric 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 numeric 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