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

# XUserGetState

> XUserGetState

# XUserGetState

사용자의 상태를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XUserGetState(  
         XUserHandle user,  
         XUserState* state  
)  
```

### 매개변수

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

상태를 가져올 사용자에 대한 핸들입니다.

*state*   \_Out\_\
형식: [XUserState\*](/reference/system/xuser/enums/xuserstate)

특정 사용자의 상태를 포함합니다.

### 반환값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.\
오류 코드 목록은 [Error Codes](/reference/errorcodes)를 참조하십시오.

## 설명

사용자는 게임 타이틀 내에서 세 가지 상태로 존재할 수 있습니다. 자세한 내용은 [XUserState](/reference/system/xuser/enums/xuserstate)를 참조하십시오.

사용자의 상태나 정보 변경을 모니터링하려면 [XUserRegisterForChangeEvent](/reference/system/xuser/functions/xuserregisterforchangeevent) 함수를 호출합니다. 이 함수는 [XUserChangeEvent](/reference/system/xuser/enums/xuserchangeevent) 열거형을 구독합니다.

## 요구 사항

**헤더:** XUser.h

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

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

## 함께 보기

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

[XUserState](/reference/system/xuser/enums/xuserstate)

[XUserRegisterForChangeEvent](/reference/system/xuser/functions/xuserregisterforchangeevent)

[XUserChangeEvent](/reference/system/xuser/enums/xuserchangeevent)


## Related topics

- [XUserGetMaxUsers](/ko/reference/system/xuser/functions/xusergetmaxusers.md)
- [XUserGetGamertag](/ko/reference/system/xuser/functions/xusergetgamertag.md)
- [XUserState](/ko/reference/system/xuser/enums/xuserstate.md)
- [XUserGetLocalId](/ko/reference/system/xuser/functions/xusergetlocalid.md)
- [사용자 ID 및 XUser](/ko/build/core-features/common/user/player-identity-xuser.md)