TipcSrvConnGetServerNamesList

Name

TipcSrvConnGetServerNamesList — get the server names of the connection to RTserver

Synopsis

T_BOOL TipcSrvConnGetServerNamesList(srv, server_names_list_return) 
T_IPC_SRV srv; 
T_STR_LIST *server_names_list_return; 

Arguments

srv — connection to RTserver

server_names_list_return — storage for the string list of server names

Return Values

TRUE if the server names were successfully retrieved for the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnGetServerNamesList gets the server names of the connection to RTserver.

Caution

The storage pointed to by server_names_list_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

TipcSrvConnSetServerNamesList, TipcSrvConnSetServerNames

Examples

This example gets the RTclient’s server names:

T_STR_LIST server_names; 
 
if (!TipcSrvConnGetServerNamesList(srv, &server_names)) { 
  return;  /* error */ 
}