TipcSrvConnSubjectGetDefaultPrefix

Name

TipcSrvConnSubjectGetDefaultPrefix — get the default subject prefix of the connection to RTserver

Synopsis

T_BOOL TipcSrvConnSubjectGetDefaultPrefix(srv, default_prefix_return) 
T_IPC_SRV srv; 
T_STR *default_prefix_return; 

Arguments

srv — connection to RTserver

default_prefix_return — returned default subject prefix

Return Values

TRUE if the default subject prefix was successfully retrieved for the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnSubjectGetDefaultPrefix gets the default subject prefix of the connection to RTserver.

Caution

The storage pointed to by default_prefix_return should not be modified or freed. The storage is thread safe, but may be overwritten by subsequent calls to SmartSockets APIs within the same thread. If you wish to preserve the value, you should make a copy of the value.

See Also

TipcSrvConnSubjectSetDefaultPrefix

Examples

This example gets the RTclient’s default subject prefix:

T_STR default_prefix; 
 
if (!TipcSrvConnSubjectGetDefaultPrefix(srv, &default_prefix)) { 
  return;  /* error */ 
}