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

# XUserGetGamertag

> XUserGetGamertag

# XUserGetGamertag

특정 사용자의 게이머태그를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  
```

### 매개변수

*user*   \_In\_\
형식: XUserHandle

게이머태그를 가져올 사용자에 대한 핸들입니다.

*gamertagComponent*   \_In\_\
형식: [XUserGamertagComponent](https://docs.xbox.com/ko/reference/system/xuser/enums/xusergamertagcomponent.md)

가져올 게이머태그의 유형입니다.

*gamertagSize*   \_In\_\
형식: size\_t

*gamertag* 매개변수의 버퍼 크기(바이트)입니다.

*gamertag*   \_Out\_writes\_bytes\_to\_(gamertagSize,*gamertagUsed)\
형식: char*

특정 사용자의 게이머태그를 포함합니다.

*gamertagUsed*   \_Out\_opt\_\
형식: size\_t\*

게이머태그를 담기 위한 버퍼의 양을 포함합니다.

### 반환값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

| 반환 코드 | 설명 |
| - | - |
| S\_OK | 작업이 성공했습니다. |
| E\_GAMEUSER\_RESOLVE\_USER\_ISSUE\_REQUIRED | 사용자가 UI를 사용하여 문제를 해결해야 합니다. 사용자에게 UI를 표시하려면 [XUserResolveIssueWithUiAsync](https://docs.xbox.com/ko/reference/system/xuser/functions/xuserresolveissuewithuiasync.md)를 호출합니다. |
| E\_INSUFFICIENT\_BUFFER | *gamertagSize*로 지정된 버퍼 크기가 요청된 구성 요소를 담기에 충분하지 않습니다. |
| E\_INVALIDARG | 잘못된 *gamertagComponent*가 제공되었습니다. |

오류 코드 목록은 [Error Codes](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하십시오.

## 설명

특정 사용자의 사용자 ID를 가져오려면 [XUserGetId](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetid.md)를 호출합니다.

특정 사용자의 상태를 가져오려면 [XUserGetState](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetstate.md)를 호출합니다.

특정 사용자의 연령 그룹을 가져오려면 [XUserGetAgeGroup](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetagegroup.md)을 호출합니다.

## 요구 사항

**헤더:** XUser.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, Steam Deck, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XUser](https://docs.xbox.com/ko/reference/system/xuser/xuser_members.md)

[XUserGetId](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetid.md)

[XUserGetState](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetstate.md)

[XUserGetAgeGroup](https://docs.xbox.com/ko/reference/system/xuser/functions/xusergetagegroup.md)


## Related topics

- [XUserGamertagComponent](https://docs.xbox.com/ko/reference/system/xuser/enums/xusergamertagcomponent.md)
- [모던 게이머태그의 모범 사례 및 테스트](https://docs.xbox.com/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-gamertags-best-practices-and-testing.md)
- [게이머태그 개요](https://docs.xbox.com/ko/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)
- [XBOX 게임에 대한 XBOX 요구 사항](https://docs.xbox.com/ko/publishing/certification/xbox-requirements.md)
- [XBOX 게임에 대한 인증 테스트 XBOX 요구 사항](https://docs.xbox.com/ko/publishing/certification/console-cert-tested-requirements.md)