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

# XblPresenceTrackUsers

> Adds users to the list of users for whom XSAPI tracks real-time device and title Presence changes.

Configures the list of users for whom real-time device and title presence updates will be tracked.

## Syntax

```cpp theme={null}
HRESULT XblPresenceTrackUsers(  
         XblContextHandle xblContextHandle,  
         const uint64_t* xuids,  
         size_t xuidsCount  
)  
```

### Parameters

*xblContextHandle*   \_In\_\
Type: [XblContextHandle](https://docs.xbox.com/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

XBOX services context for the local user.

*xuids*   \_In\_\
Type: uint64\_t\*

Array of XboxUserIDs to append to the existing list of tracked Users.

*xuidsCount*   \_In\_\
Type: size\_t

Length of xuids array.

### Return value

Type: HRESULT

Returns `S_OK` on success, or an error code on failure. Possible error codes include the following. This list isn't exhaustive.

| Return code | Description |
| - | - |
| E\_INVALIDARG | *xblContextHandle* or *xuids* is null. |

## Remarks

Updates will be delivered via XblPresenceDevicePresenceChangedHandlers and XblPresenceTitlePresenceChangedHandlers. Note that the set of tracked users can be updated independent from the handlers.

Register handlers with [XblPresenceAddDevicePresenceChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresenceadddevicepresencechangedhandler.md) and [XblPresenceAddTitlePresenceChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresenceaddtitlepresencechangedhandler.md). XSAPI creates and removes the Real-Time Activity (RTA) subscriptions for tracked users. Register title Presence handlers before you track users.

Tracking is reference counted. Call [XblPresenceStopTrackingUsers](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencestoptrackingusers.md) once for each successful call to this function for the same user.

This function replaces the deprecated `XblPresenceSubscribeToDevicePresenceChange` function. To replace the deprecated `XblPresenceSubscribeToTitlePresenceChange` function, also call [XblPresenceTrackAdditionalTitles](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencetrackadditionaltitles.md) for titles other than the current title.

## 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)\
[XblPresenceStopTrackingUsers](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencestoptrackingusers.md)\
[Handling a device Presence change](https://docs.xbox.com/services/xbox-services/community/presence/how-to/live-handling-a-device-presence-change.md)


## Related topics

- [XblPresenceTrackAdditionalTitles](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencetrackadditionaltitles.md)
- [XblPresenceStopTrackingUsers](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencestoptrackingusers.md)
- [Handling a device Presence change](https://docs.xbox.com/services/xbox-services/community/presence/how-to/live-handling-a-device-presence-change.md)
- [XblPresenceAddTitlePresenceChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresenceaddtitlepresencechangedhandler.md)
- [XblPresenceAddDevicePresenceChangedHandler](https://docs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresenceadddevicepresencechangedhandler.md)