Receive notifications about changes to selected topics.

Functions
bool	diffusion_topic_notification_registration_select (SESSION_T *session, const DIFFUSION_TOPIC_NOTIFICATION_REGISTRATION_PARAMS_T params, DIFFUSION_API_ERROR *api_error)
	Request to receive notifications for all topics matched by the provided selector.
bool	diffusion_topic_notification_registration_deselect (SESSION_T *session, const DIFFUSION_TOPIC_NOTIFICATION_REGISTRATION_PARAMS_T params, DIFFUSION_API_ERROR *api_error)
	Request to stop receiving notifications for all topics matched by the given selector.
bool	diffusion_topic_notification_add_listener (SESSION_T *session, const DIFFUSION_TOPIC_NOTIFICATION_LISTENER_T listener, DIFFUSION_API_ERROR *api_error)
	Register a listener to receive topic notifications.

Detailed Description

Function Documentation

diffusion_topic_notification_add_listener()

bool diffusion_topic_notification_add_listener	(	SESSION_T *	session,
		const DIFFUSION_TOPIC_NOTIFICATION_LISTENER_T	listener,
		DIFFUSION_API_ERROR *	api_error
	)

Register a listener to receive topic notifications.

Parameters

session	The current session. If NULL, this function returns immediately.
listener	The listener to receive topic specification notifications
api_error	Populated on API error. Can be NULL.

Returns

true if the operation was successful. False, otherwise. In this case, if a non-NULL api_error pointer has been provided, this will be populated with the error information and should be freed with diffusion_api_error_free.

diffusion_topic_notification_registration_deselect()

bool diffusion_topic_notification_registration_deselect	(	SESSION_T *	session,
		const DIFFUSION_TOPIC_NOTIFICATION_REGISTRATION_PARAMS_T	params,
		DIFFUSION_API_ERROR *	api_error
	)

Request to stop receiving notifications for all topics matched by the given selector.

Parameters

session	The session handle. If NULL, this function returns immediately.
params	Parameters defining the diffusion_topic_notification_registration_deselect request and notification callbacks.
api_error	Populated on API error. Can be NULL.

Returns

true if the operation was successful. False, otherwise. In this case, if a non-NULL api_error pointer has been provided, this will be populated with the error information and should be freed with diffusion_api_error_free.

diffusion_topic_notification_registration_select()

bool diffusion_topic_notification_registration_select	(	SESSION_T *	session,
		const DIFFUSION_TOPIC_NOTIFICATION_REGISTRATION_PARAMS_T	params,
		DIFFUSION_API_ERROR *	api_error
	)

Request to receive notifications for all topics matched by the provided selector.

Parameters

session	The session handle. If NULL, this function returns immediately.
params	Parameters defining the diffusion_topic_notification_registration_select request and notification callbacks.
api_error	Populated on API error. Can be NULL.

Returns

true if the operation was successful. False, otherwise. In this case, if a non-NULL api_error pointer has been provided, this will be populated with the error information and should be freed with diffusion_api_error_free.