> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblPresenceRecordGetUserState

> XblPresenceRecordGetUserState

Get the global presence state for a presence record.

## Syntax

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

### Parameters

*handle*   \_In\_\
Type: [XblPresenceRecordHandle](https://docs.xbox.com/reference/live/xsapi-c/presence_c/handles/xblpresencerecordhandle.md)

Handle for the presence record returned from a GetPresence API.

*userState*   \_Out\_\
Type: [XblPresenceUserState\*](https://docs.xbox.com/reference/live/xsapi-c/presence_c/enums/xblpresenceuserstate.md)

A caller allocated struct that passes back the presence state of the record.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Requirements

**Header:** presence\_c.h

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[presence\_c](https://docs.xbox.com/reference/live/xsapi-c/presence_c/presence_c_members.md)


## Related topics

- [XblPresenceUserState](https://docs.xbox.com/reference/live/xsapi-c/presence_c/enums/xblpresenceuserstate.md)
- [presence_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/presence_c/presence_c_members.md)
- [XblPresenceGetPresenceForMultipleUsersResult](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersresult.md)
- [XblPresenceRecordGetXuid](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetxuid.md)
- [XblPresenceRecordGetDeviceRecords](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetdevicerecords.md)