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

# XblRealTimeActivityConnectionStateChangeHandler

> Callback type that's called when the connection to the Real-Time Activity (RTA) service changes state.

Handler function for when the client service loses or gains connectivity to the Real-Time Activity (RTA) service.

## Syntax

```cpp theme={null}
void XblRealTimeActivityConnectionStateChangeHandler(  
         void* context,  
         XblRealTimeActivityConnectionState connectionState  
)  
```

### Parameters

*context*   \_In\_opt\_\
Type: void\*

Caller context that will be passed back to the handler function.

*connectionState*   \_In\_\
Type: [XblRealTimeActivityConnectionState](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/enums/xblrealtimeactivityconnectionstate.md)

State of the connection.

### Return value

Type: void

## Requirements

**Header:** real\_time\_activity\_c.h

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

## See also

[real\_time\_activity\_c](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/real_time_activity_c_members.md)


## Related topics

- [XblRealTimeActivityAddConnectionStateChangeHandler](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityaddconnectionstatechangehandler.md)
- [real_time_activity_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/real_time_activity_c_members.md)
- [Multiplayer Session Directory overview](https://docs.xbox.com/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblRealTimeActivityRemoveConnectionStateChangeHandler](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityremoveconnectionstatechangehandler.md)
- [XblRealTimeActivitySubscriptionErrorHandler](https://docs.xbox.com/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivitysubscriptionerrorhandler.md)
