TipcSrvConnCreate

Name

TipcSrvConnCreate — create an RTclient connection handle to an RTserver

Synopsis

T_IPC_SRV TipcSrvConnCreate(unique_subject, project, server_names, 
default_subject_prefix) 
T_STR unique_subject; 
T_STR project; 
T_STR server_names; 
T_STR default_subject_prefix; 

Arguments

unique_subject — unique subject to use for the connection, or NULL to use the value of the Unique_Subject option

project — project to use for the connection, or NULL to use the value of the Project option

server_names — comma delimited list of logical connection names to use for the connection, or NULL to use the value of the Server_Names option

default_subject_prefix — default subject prefix to use for the connection, or NULL to use the value of the Default_Subject_Prefix option

Return Values

The new connection handle if successful, NULL otherwise.

Diagnostics

If TipcSrvConnCreate fails, it returns NULL and sets the global SmartSockets error number to:

Description

TipcSrvConnCreate creates an RTclient connection handle to an RTserver. 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 an RTclient/RTserver connection handle:

T_IPC_SRV srv; 
 
srv = TipcSrvConnCreate("/trader", NULL, "tcp:moe, tcp:larry", 
NULL);