TipcSrvGetCurrentConnectedLcn

Name

TipcSrvGetCurrentConnectedLcn -- get the logical connection name of connected RTserver

Synopsis

T_BOOL TipcSrvGetCurrentConnectedLcn(lcn_return) 
T_STR lcn_return; 

Arguments

lcn_return — storage for RTserver logical connection name

Return Values

TRUE if logical connection name was successfully retrieved from RTserver handle, FALSE otherwise.

Diagnostics

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

Description

TipcSrvGetCurrentConnectedLcn gets the logical connection name of the RTserver to which this RTclient is connected. If the function cannot find the logical connection name, it stores the string Unknown in lcn_return.

Caution

There is no way to know ahead of time how much storage is needed for lcn_return.

The value of lcn_return cannot be NULL. Storage for lcn_return must be managed by the caller.

If TipcSrvGetCurrentConnectedLcn returns FALSE, it does not store a value in lcn_return.

See Also

TipcSrvConnGetCurrentConnectedLcn

Examples

This example prints the name of the logical connection name of RTserver:

 
T_CHAR lcn[80]; 
 
if (!TipcSrvGetCurrentConnectedLcn(lcn)) { 
  return;  /* error */ 
} 
 
TutOut("Current Logical Connection Name is <%s>\n", lcn);