> ## 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\*](/zh-TW/reference/system/xuser/enums/xuserstate)

包含特定使用者的狀態。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。\
如需錯誤碼清單，請參閱[錯誤碼](/zh-TW/reference/errorcodes)。

## 備註

使用者在遊戲中可能處於三種狀態。如需詳細資料，請參閱 [XUserState](/zh-TW/reference/system/xuser/enums/xuserstate)。

若要監視使用者狀態或資訊的變更，請呼叫 [XUserRegisterForChangeEvent](/zh-TW/reference/system/xuser/functions/xuserregisterforchangeevent) 函式。此函式會訂閱 [XUserChangeEvent](/zh-TW/reference/system/xuser/enums/xuserchangeevent) 列舉。

## 需求

**標頭：** XUser.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XUser](/zh-TW/reference/system/xuser/xuser_members)

[XUserState](/zh-TW/reference/system/xuser/enums/xuserstate)

[XUserRegisterForChangeEvent](/zh-TW/reference/system/xuser/functions/xuserregisterforchangeevent)

[XUserChangeEvent](/zh-TW/reference/system/xuser/enums/xuserchangeevent)


## Related topics

- [XUserGetState](/reference/system/xuser/functions/xusergetstate.md)
- [XUserState](/reference/system/xuser/enums/xuserstate.md)
- [XUserGetMaxUsers](/reference/system/xuser/functions/xusergetmaxusers.md)
- [XUserGetGamertag](/reference/system/xuser/functions/xusergetgamertag.md)
- [XUserGetLocalId](/reference/system/xuser/functions/xusergetlocalid.md)