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

# XblPresenceRecordGetUserState

> XblPresenceRecordGetUserState

# XblPresenceRecordGetUserState

取得線上狀態記錄的全域線上狀態。

## 語法

```cpp theme={null}
HRESULT XblPresenceRecordGetUserState(  
         XblPresenceRecordHandle handle,  
         XblPresenceUserState* userState  
)  
```

### 參數

*handle*   \_In\_\
類型：[XblPresenceRecordHandle](/zh-TW/reference/live/xsapi-c/presence_c/handles/xblpresencerecordhandle)

從 GetPresence API 傳回之線上狀態記錄的控制代碼。

*userState*   \_Out\_\
類型：[XblPresenceUserState\*](/zh-TW/reference/live/xsapi-c/presence_c/enums/xblpresenceuserstate)

由呼叫端配置的結構，用來傳回記錄的線上狀態。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 需求

**標頭：** presence\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

[presence\_c](/zh-TW/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceUserState](/zh-TW/reference/live/xsapi-c/presence_c/enums/xblpresenceuserstate.md)
- [XblPresenceGetPresenceForMultipleUsersResult](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersresult.md)
- [XblPresenceRecordGetDeviceRecords](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetdevicerecords.md)
- [XblPresenceRecordGetXuid](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetxuid.md)
- [XblSocialManagerPresenceRecordIsUserPlayingTitle](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerpresencerecordisuserplayingtitle.md)