TipcSrvIsRunning

Name

TipcSrvIsRunning — check if the RTclient can create a connection to RTserver

Synopsis

T_BOOL TipcSrvIsRunning() 

Arguments

None

Return Values

TRUE if the RTclient can create a connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvIsRunning checks if the RTclient can create a connection to RTserver. If the RTclient already has a full connection to RTserver, then TipcSrvIsRunning returns TRUE immediately. Otherwise TipcSrvIsRunning attempts to create a connection in a fashion similar to that of TipcSrvCreate, except that TipcSrvIsRunning never attempts to start RTserver. If TipcSrvIsRunning can create a connection, it destroys the connection and return TRUE.

Caution

TipcSrvIsRunning actually tries to create a connection to RTserver.

See Also

TipcSrvCreate, TipcSrvDestroy

Examples

This example checks if RTserver is already running with TipcSrvIsRunning:

if (TipcSrvIsRunning()) { 
  TutOut("RTserver is running.\n"); 
} 
else { 
  TutOut("RTserver is not running.\n"); 
}