TipcSrvConnSubjectGetUnique

Name

TipcSrvConnSubjectGetUnique — get the unique subject of the connection to RTserver

Synopsis

T_BOOL TipcSrvConnSubjectGetUnique(srv, unique_subject_return) 
T_IPC_SRV srv; 
T_STR *unique_subject_return; 

Arguments

srv — connection to RTserver

unique_subject_return — returned unique subject

Return Values

TRUE if the unique subject was successfully retrieved from the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnSubjectGetUnique gets the unique subject of the connection to RTserver.

Caution

None

See Also

TipcSrvConnSubjectSetUnique

Examples

This example gets the RTclient’s unique subject:

T_STR unique_subject; 
 
if (!TipcSrvConnSubjectGetUnique(srv, &unique_subject)) { 
  return;  /* error */ 
}