TipcSrvConnTrafficGetMsgsRecv8

Name

TipcConnTrafficGetMsgsRecv8 — get the total number of messages received on a connection

The following version of this function is deprecated in release 6.7 and later. The previous form supersedes it. We retain the older form only for backward source compatibility. TipcConnTrafficGetMsgsRecv — get the total number of messages received on a connection

Synopsis

T_BOOL TipcSrvConnTrafficGetMsgsRecv8(srv, msgs_recv_return) 
T_IPC_SRV srv; 
T_INT8 *msgs_recv_return; 

Arguments

srv — connection handle to RTserver

msgs_recv_return — returned number of messages

Return Values

TRUE if the number of messages was sucessfully retrieved, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnTrafficGetMsgsRecv8 retrieves the total number of messages received on a connection.

See Also

TipcSrvConnTrafficGetMsgsSent8

Examples

This example retrieves the number of messages received on a connection:

T_IPC_SRV srv; 
T_INT8 msgs_recv; 
. 
. 
. 
if (!TipcSrvConnTrafficGetMsgsRecv8(srv, &msgs_recv)) { 
  return;  /* error */ 
}