Diffusion C API  5.9.24
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Maintaining topic state.

Functions

CONVERSATION_ID_Tregister_update_source (SESSION_T *session, const UPDATE_SOURCE_REGISTRATION_PARAMS_T params)
 Register a topic update source. More...
 
void deregister_update_source (SESSION_T *session, const UPDATE_SOURCE_DEREGISTRATION_PARAMS_T params)
 Deregister a topic update source. More...
 
void update (SESSION_T *session, const UPDATE_SOURCE_PARAMS_T params)
 Update topic content. More...
 

Detailed Description

Function Documentation

void deregister_update_source ( SESSION_T session,
const UPDATE_SOURCE_DEREGISTRATION_PARAMS_T  params 
)

Deregister a topic update source.

Deregisters an existing update source from Diffusion.

Parameters
sessionThe session handle. If NULL, this function returns immediately.
paramsParameter structure describing the deregistration request.
CONVERSATION_ID_T* register_update_source ( SESSION_T session,
const UPDATE_SOURCE_REGISTRATION_PARAMS_T  params 
)

Register a topic update source.

Registers an update source with Diffusion, requesting responsibility for managing topic state for all topics from a given point and below.

Parameters
sessionThe session handle. If NULL, this function returns immediately with a NULL value.
paramsParameter structure describing the registration request.
Returns
A conversation ID that can be used as a handle to future topic updates by this update source, or NULL if the supplied session is NULL.
void update ( SESSION_T session,
const UPDATE_SOURCE_PARAMS_T  params 
)

Update topic content.

Sends new topic content to Diffusion, for transmission to subscribed clients.

Parameters
sessionThe session handle. If NULL, this function returns immediately.
paramsParameter structure describing which topic to update, the new content, how the update is to be applied, and callbacks to handle success or failure notifications.