Diffusion C API  5.9.24
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
svc-ping-user.h File Reference

Functions to handle user-initiated ping requests and responses. More...

Data Structures

struct  svc_ping_user_request_s
 Structure of a user ping request. More...
 
struct  svc_ping_user_response_s
 Structure of a user ping response. More...
 
struct  ping_user_handlers_s
 
struct  ping_user_params_s
 Structure supplied when registering a user ping handler or sending a user ping request. More...
 

Macros

#define PING_USER_HANDLERS
 Callback handlers that can be registered for dealing with user ping responses.
 

Typedefs

typedef struct
svc_ping_user_request_s 
SVC_PING_USER_REQUEST_T
 Structure of a user ping request.
 
typedef struct
svc_ping_user_response_s 
SVC_PING_USER_RESPONSE_T
 Structure of a user ping response.
 
typedef int(* on_ping_user_request_cb )(SESSION_T *session, const SVC_PING_USER_REQUEST_T *request, void *context)
 Callback for ping_user_register_handler(). More...
 
typedef int(* on_ping_user_response_cb )(SESSION_T *session, void *context)
 Callback for ping_user(). More...
 
typedef struct ping_user_params_s PING_USER_PARAMS_T
 Structure supplied when registering a user ping handler or sending a user ping request.
 

Functions

void ping_user_register_handler (SESSION_T *session, const PING_USER_PARAMS_T params)
 Register a user-defined handler for user pings. More...
 
void ping_user (SESSION_T *session, const PING_USER_PARAMS_T params)
 Explicitly send a user ping to Diffusion. More...
 

Detailed Description

Functions to handle user-initiated ping requests and responses.

Typedef Documentation

typedef int(* on_ping_user_request_cb)(SESSION_T *session, const SVC_PING_USER_REQUEST_T *request, void *context)

Callback for ping_user_register_handler().

Parameters
sessionThe current active session.
requestThe incoming ping request.
contextUser-supplied context from the initial registration call.
Returns
HANDLER_SUCCESS or HANDLER_FAILURE.
typedef int(* on_ping_user_response_cb)(SESSION_T *session, void *context)

Callback for ping_user().

Parameters
sessionThe current active session.
contextUser-supplied context from the initial registration call.
Returns
HANDLER_SUCCESS or HANDLER_FAILURE.