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

# XblRealTimeActivityAddConnectionStateChangeHandler

> XblRealTimeActivityAddConnectionStateChangeHandler

# XblRealTimeActivityAddConnectionStateChangeHandler

注册处理程序函数，用于在客户端服务失去或获得与实时活动服务的连接时接收通知。

## 语法

```cpp theme={null}
XblFunctionContext XblRealTimeActivityAddConnectionStateChangeHandler(  
         XblContextHandle xboxLiveContext,  
         XblRealTimeActivityConnectionStateChangeHandler* handler,  
         void* context  
)  
```

### 参数

*xboxLiveContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XBOX Live 上下文句柄。

*handler*   \_In\_\
类型：XblRealTimeActivityConnectionStateChangeHandler\*

接收通知的回调函数。

*context*   \_In\_opt\_\
类型：void\*

将回传给处理程序函数的调用方上下文。

### 返回值

类型：XblFunctionContext

可用于注销事件处理程序的 XblFunctionContext 对象。

## 要求

**头文件：** real\_time\_activity\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[real\_time\_activity\_c](/reference/live/xsapi-c/real_time_activity_c/real_time_activity_c_members)


## Related topics

- [XblRealTimeActivityConnectionStateChangeHandler](/zh-CN/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityconnectionstatechangehandler.md)
- [XblRealTimeActivityRemoveConnectionStateChangeHandler](/zh-CN/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityremoveconnectionstatechangehandler.md)
- [XblRealTimeActivityConnectionState](/zh-CN/reference/live/xsapi-c/real_time_activity_c/enums/xblrealtimeactivityconnectionstate.md)
- [XblRealTimeActivityAddResyncHandler](/zh-CN/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityaddresynchandler.md)
- [XblRealTimeActivityResyncHandler](/zh-CN/reference/live/xsapi-c/real_time_activity_c/functions/xblrealtimeactivityresynchandler.md)