TipcSrvConnCreateNamed

Name

TipcSrvConnCreateNamed — creates a named RTclient connection handle to an RTserver

Synopsis

T_IPC_SRV TipcSrvConnCreateNamed(name) 
T_STR name; 

Arguments

name — string representing the name of the connection

Return Values

The new connection handle is returned.

Diagnostics

None

Description

TipcSrvConnCreateNamed creates a named RTclient connection handle to an RTserver. The name is associated with named options, which are set by the SETNOPT command or by setting an option that was looked up by TutOptionNamedLookup. The connection is not opened until TipcSrvConnOpen is called or until a function that requires a connection is called, such as TipcSrvConnMsgSend, and the Server_Auto_Connect option is set to TRUE.

Caution

None

See Also

TipcSrvConnDestroy

Examples

This example creates a named RTclient/RTserver connection handle:

T_IPC_SRV srv; 
 
TutCommandParseStr("setnopt client Unique_subject /trader"); 
TutCommandParseStr("setnopt client Server_Names tcp:moe, 
tcp:larry"); 
 
srv = TipcSrvConnCreateNamed("client");