SP_connect is the initial
call an application must make to establish a connection with
a Spread daemon. All other spread calls must refer to a valid
mbox returned by this function.
The spread_name is the name of the Spread daemon
to connect to. It should be a string in one of the following
|This will connect to the Spread daemon on
the local machine running on port 4803. This form cannot
be used to connect to a Windows95/NT machine.
|This will also connect to the Spread daemon on the local
machine running on port 4803. This form can be used on
email@example.com or firstname.lastname@example.org
|This will connect to the machine identified by either
domain name or IP address at the specified port.
The private_name is the name this connection would
like to be known as. It must be unique on the machine running
the spread daemon. The name can be of at most MAX_PRIVATE_NAME
characters, with the same character restrictions as a group
name (mainly it cannot contain the '#' character). If the
application does not care what name it uses, it can pass in
a NULL pointer into this field and the daemon will assign
the connection a unique, random name.
The priority is a 0/1 flag for whether this connection
will be a "Priority" connection or not. Currently
this has no effect.
The group_membership is a boolean integer. If 1
then the application will receive group membership messages
for this connection, if 0 then the application will not receive
any membership change messages.
The mbox should be a pointer to a mailbox variable.
After the SP_connect call returns this variable will hold
the mbox for the connection.
The private_group should be a pointer to a string
big enough to hold at least MAX_GROUP_NAME characters. After
the Connect call returns it will contain the private group
name of this connection. This group name can be used to send
unicast messages to this connection and no one can join this