TipcDispatcherSrvAdd

Name

TipcDispatcherSrvAdd — add an RTserver connection to a dispatcher

Synopsis

T_BOOL TipcDispatcherSrvAdd(dispatcher, srv) 
T_IPC_DISPATCHER dispatcher; 
T_IPC_SRV srv;

Arguments

dispatcher — the dispatcher

srv — connection to the RTserver

Return Values

TRUE if the RTserver connection was successfully added to a dispatcher, FALSE otherwise.

Diagnostics

If TipcDispatcherSrvAdd fails, it returns FALSE and sets the global SmartSockets error number to:

T_ERR_NULL_PTR — srv or dispatcher was null

T_ERR_ALREADY_EXISTS — srv was already added to dispatcher. You misspelled the identifier or tried to add the connection twice.

Description

TipcDispatcherSrvAdd adds an RTserver connection to a dispatcher. A dispatcher reads messages from multiple connections at one time and is an alternative to calling TipcSrvConnMainLoop, or TipcSrvConnMsgNext, TipcSrvConnMsgProcess and TipcMsgDestroy on each connection individually.

Caution

Calling TipcSrvConnMsgNext, TipcSrvConnMsgSearch, TipcSrvConnMsgSearchType, TipcSrvConnMsgSendRpc or TipcSrvConnMainLoop might cause a dispatcher to block until the called function returns.

Examples

This example adds an RTserver connection to a dispatcher:

 
if (!TipcDispatcherSrvAdd(dispatcher, srv)) { 
  return;  /* error */ 
}