Previous topicNext topic
Help > XEngine_Core > XEngine_Core > NetCore_SocketOperator >
SocketOpt_HeartBeat_ActiveAddrEx

函数

SocketOpt_HeartBeat_ActiveAddrEx

功能

激活一个客户端

语法

BOOL SocketOpt_HeartBeat_ActiveAddrEx(XHANDLE xhNet, LPCSTR lpszClientAddr, XENGINE_PROTOCOL_HEARTBEAT *pSt_ProtocolHeartBeat = NULL)

参数

 参数.一:lpszClientAddr
  In/Out:In
  类型:常量字符指针
  可空:N
  意思:要激活的客户端地址,唯一标识符,可以是任意字符串
 参数.二:pSt_ProtocolHeartBeat
  In/Out:In
  类型:数据结构指针
  可空:Y
  意思:心跳协议,可以为NULL

返回值

类型:逻辑型
意思:是否成功

备注

每收到一次心跳消息,都需要调用此函数进行激活,超过设定时间将被认为断线
如果客户端不存在,此函数会调用SocketOpt_HeartBeat_Insert插入一个新的客户端