TipcSrvConnSetServerNamesList

Name

TipcSrvConnSetServerNamesList — set the server names of the connection to RTserver in a linked list of strings

Synopsis

T_BOOL TipcSrvConnSetServerNamesList(srv, server_names_list) 
T_IPC_SRV srv; 
T_STR_LIST server_names_list; 

Arguments

srv — connection to RTserver

server_names_list — string list of server names

Return Values

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

Diagnostics

If TipcSrvConnSetServerNamesList fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvConnSetServerNamesList sets the server names of the connection to RTserver in a linked list of strings. The string list values are copied to internal storage, so the caller does not need to maintain storage for them.

Caution

None

See Also

TipcSrvConnCreate, TipcSrvConnGetServerNamesList

Examples

This example sets the RTclient’s server names:

T_OPTION option; 
T_STR_LIST server_names; 
 
if (NULL == (option = TutOptionLookup("server_names"))) { 
  return;  /* error */ 
} 
 
if (!TutOptionGetStrList(option, &server_names)) { 
  return;  /* error */ 
} 
 
if (!TipcSrvConnSetServerNamesList(srv, server_names)) { 
  return;  /* error */ 
}