TipcSrvConnUnlock

Name

TipcSrvConnUnlock — release exclusive access to the connection

Synopsis

T_BOOL TipcSrvConnUnlock(srv) 
T_IPC_SRV srv; 

Arguments

srv — connection handle to RTserver

Return Values

TRUE if the connection to RTserver was successfully unlocked, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnUnlock unlocks all of the internal synchronization objects within the connection to RTserver.

Caution

Every call to TipcSrvConnLock must be balanced by a call to TipcSrvConnUnlock.

See Also

TipcConnUnlock, TipcSrvConnLock; see the TIBCO SmartSockets Utilities for information on TutRwMutexUnlock.

Examples

This example locks and unlocks the connection to RTserver:

if (!TipcSrvConnLock(srv)) { 
  return;  /* error */ 
} 
 
/* At this point, several TipcSrvConn* functions could be called and there would be no risk of any 
other thread accessing the connection. The connection must be unlocked with TipcSrvConnUnlock 
when exclusive access is no longer needed. */ 
 
if (!TipcSrvConnUnlock(srv)) { 
  return;  /* error */ 
}