TipcSrvMsgProcess

Name

TipcSrvMsgProcess — process a message in the connection to RTserver

Synopsis

T_BOOL TipcSrvMsgProcess(msg) 
T_IPC_MSG msg; 

Arguments

msg — message to process

Return Values

TRUE if message was successfully processed, FALSE otherwise.

Diagnostics

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

Description

TipcSrvMsgProcess 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.

TipcSrvMsgProcess may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvMsgProcess processes the message using the warm connection. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

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

See Also

TipcConnMsgProcess, TipcSrvDefaultCbCreate, TipcSrvMsgNext, TipcSrvMainLoop, TipcSrvProcessCbCreate

Examples

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

msg = TipcSrvMsgNext(T_TIMEOUT_FOREVER); 
if (msg == NULL) { 
  return;  /* error */ 
}  
 
if (!TipcSrvMsgProcess(msg)) { 
  return;  /* error */ 
}  
 
if (!TipcMsgDestroy(msg)) { 
  return;  /* error */ 
}