> ## 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 프로필을 나타냅니다.

## Syntax

```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  
```

### Members

*xboxUserId*\
Type: uint64\_t

사용자의 XBOX 사용자 ID입니다.

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

애플리케이션 UI에서 사용할 UTF-8로 인코딩된 사용자의 표시 이름입니다. 항상 사용자의 gamertag이며 gameDisplayName 필드와 동일합니다.

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

사용자의 gamer pic에 대한 UTF-8로 인코딩된 Uri입니다. 항상 gameDisplayPictureResizeUri 필드와 동일합니다. Uri는 크기 조정이 가능한 Uri입니다. '\&format={format}\&w={width}\&h={height}을 추가하여 다음 크기와 형식 중 하나를 지정할 수 있습니다:<br /> Format: png<br /> Width Height<br /> 64 64<br /> 208 208<br /> 424 424<br />

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

애플리케이션 UI에서 사용할 UTF-8로 인코딩된 사용자의 표시 이름입니다. 항상 사용자의 gamertag이며 appDisplayName 필드와 동일합니다.

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

사용자의 gamer pic에 대한 UTF-8로 인코딩된 Uri입니다. 항상 appDisplayPictureResizeUri 필드와 동일합니다. Uri는 크기 조정이 가능한 Uri입니다. '\&format={format}\&w={width}\&h={height}을 추가하여 다음 크기와 형식 중 하나를 지정할 수 있습니다:<br /> Format: png<br /> Width Height<br /> 64 64<br /> 208 208<br /> 424 424<br />

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

UTF-8로 인코딩된 사용자의 Gamerscore입니다.

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

UTF-8로 인코딩된 사용자의 클래식 gamertag입니다. 이 필드는 ASCII 문자만 사용하며 접미사를 포함하지 않습니다.

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

UTF-8로 인코딩된 사용자의 모던 gamertag입니다. 이 필드는 특정 범위의 UTF-8 문자를 사용하며 접미사를 포함하지 않습니다. 고유성이 보장되지는 않습니다.

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

고유성을 보장하기 위해 모던 gamertag에 추가되는 UTF-8로 인코딩된 숫자 접미사입니다. 일부 경우에는 비어 있을 수 있습니다.

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

UTF-8로 인코딩된 고유한 모던 gamertag와 숫자 접미사입니다. 형식은 "modernGamertag#suffix"입니다. 렌더링된 문자가 16자 이하임이 보장됩니다.

## Argument of

[XblProfileGetUserProfileResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult)\
[XblProfileGetUserProfilesResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult)\
[XblProfileGetUserProfilesForSocialGroupResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult)

## Requirements

**Header:** profile\_c.h

## See also

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


## Related topics

- [XblProfileGetUserProfileResult](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)
- [XblProfileGetUserProfilesResult](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesresult.md)
- [XblProfileGetUserProfilesForSocialGroupResult](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [모던 게이머태그의 모범 사례 및 테스트](/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [XblProfileGetUserProfileAsync](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileasync.md)