solClient_flow_rxMsgDispatchFuncInfo Struct Reference

Callback information for Flow message receive dispatch. More...

#include <solClient.h>

Data Fields
solClient_dispatchType_t	dispatchType
	The type of dispatch described. More...
solClient_flow_rxMsgCallbackFunc_t	callback_p
	An application-defined callback function; may be NULL in which case the default flow receive message callback is used. More...
void *	user_p
	A user pointer to return with the callback; must be NULL if callback_p is NULL. More...
void *	rfu_p
	Reserved for future use; must be NULL. More...

Detailed Description

Callback information for Flow message receive dispatch.

This can be set on a per-subscription basis. This structure is passed to solClient_flow_topicSubscribeWithDispatch and solClient_flow_topicUnsubscribeWithDispatch.

An application may create multiple solClient_flow_rxMsgDispatchFuncInfo with different callback functions or different user pointers or both, to define alternate processing for incoming messages based on subscription used to attract the messages.

Through the use of wildcards, multiple unique subscriptions may match the same received messages, for example messages received on topic a/b will match subscriptions to a/> and a/b. In this case both dispatches are invoked on the message.

Field Documentation

solClient_flow_rxMsgCallbackFunc_t callback_p

An application-defined callback function; may be NULL in which case the default flow receive message callback is used.

solClient_dispatchType_t dispatchType

The type of dispatch described.

void* rfu_p

Reserved for future use; must be NULL.

void* user_p

A user pointer to return with the callback; must be NULL if callback_p is NULL.