> ## 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 成功或错误代码。\
有关错误代码列表，请参阅[错误代码](/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](/zh-CN/reference/system/xuser/functions/xusergetmaxusers.md)
- [XUserState](/zh-CN/reference/system/xuser/enums/xuserstate.md)
- [XUserGetGamertag](/zh-CN/reference/system/xuser/functions/xusergetgamertag.md)
- [XUserGetLocalId](/zh-CN/reference/system/xuser/functions/xusergetlocalid.md)
- [用户身份与 XUser](/zh-CN/build/core-features/common/user/player-identity-xuser.md)