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

# 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](/reference/system/xuser/enums/xusergamertagcomponent)

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

*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](/reference/system/xuser/functions/xuserresolveissuewithuiasync)를 호출합니다. |
| E\_INSUFFICIENT\_BUFFER                     | *gamertagSize*로 지정된 버퍼 크기가 요청된 구성 요소를 담기에 충분하지 않습니다.                                                                                               |
| E\_INVALIDARG                               | 잘못된 *gamertagComponent*가 제공되었습니다.                                                                                                                  |

오류 코드 목록은 [Error Codes](/reference/errorcodes)를 참조하십시오.

## 설명

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

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

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

## 요구 사항

**헤더:** XUser.h

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

**지원되는 플랫폼:** Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XUser](/reference/system/xuser/xuser_members)

[XUserGetId](/reference/system/xuser/functions/xusergetid)

[XUserGetState](/reference/system/xuser/functions/xusergetstate)

[XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup)