XUserGetGamertag

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

구문

HRESULT XUserGetGamertag(  
         XUserHandle user,
         XUserGamertagComponent gamertagComponent,
         size_t gamertagSize,  
         char* gamertag,  
         size_t* gamertagUsed  
)  

매개변수

user   _In_
형식: XUserHandle 게이머태그를 가져올 사용자에 대한 핸들입니다. gamertagComponent   _In_
형식: 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를 호출합니다.
E_INSUFFICIENT_BUFFER	gamertagSize로 지정된 버퍼 크기가 요청된 구성 요소를 담기에 충분하지 않습니다.
E_INVALIDARG	잘못된 gamertagComponent가 제공되었습니다.

오류 코드 목록은 Error Codes를 참조하십시오.

설명

특정 사용자의 사용자 ID를 가져오려면 XUserGetId를 호출합니다. 특정 사용자의 상태를 가져오려면 XUserGetState를 호출합니다. 특정 사용자의 연령 그룹을 가져오려면 XUserGetAgeGroup을 호출합니다.

요구 사항

헤더: XUser.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XUserGetGamertag

XUserGetGamertag

구문

매개변수

반환값

설명

요구 사항

함께 보기

​XUserGetGamertag

​구문

​매개변수

​반환값

​설명

​요구 사항

​함께 보기

XUserGetGamertag

구문

매개변수

반환값

설명

요구 사항

함께 보기