TipcSrvConnMsgProcess

Name

TipcSrvConnMsgProcess — process a message in the connection

Synopsis

T_BOOL TipcSrvConnMsgProcess(srv, msg) 
T_IPC_SRV srv; 
T_IPC_MSG msg; 

Arguments

srv — connection handle to RTserver

msg — message to process

Return Values

TRUE if message was successfully processed, FALSE otherwise.

Diagnostics

If TipcSrvConnMsgProcess fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvConnMsgProcess processes a message in the connection to RTserver by calling TipcConnMsgProcess. The process callbacks or default callbacks are executed. See TipcConnMsgProcess for more information on processing messages.

TipcSrvConnMsgProcess may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvConnMsgProcess processes the message using the warm connection. See TipcSrvConnOpen for more information on automatic creation of connections and warm connections to RTserver.

Caution

RTclients that receive messages with TipcSrvConnMsgNext or TipcSrvConnMsgSearch but do not call TipcSrvConnMsgProcess on those message are not monitorable with the TipcSrvMon* API or RTmon. RTclient monitoring is implemented using connection process callbacks, which are all called by TipcSrvConnMsgProcess.

See Also

TipcConnMsgProcess, TipcSrvConnDefaultCbCreate, TipcSrvConnMsgNext, TipcSrvConnMainLoop, TipcSrvConnProcessCbCreate

Examples

This example gets the next message from the connection to RTserver and processes it with TipcSrvConnMsgProcess:

msg = TipcSrvConnMsgNext(srv, T_TIMEOUT_FOREVER); 
if (msg == NULL) { 
  return;  /* error */ 
}  
 
if (!TipcSrvConnMsgProcess(srv, msg)) { 
  return;  /* error */ 
}  
 
if (!TipcMsgDestroy(msg)) { 
  return;  /* error */ 
}