gSocketClientConnectToService: gSocketClientConnectToService
Description
Attempts to create a TCP connection to a service.Usage
gSocketClientConnectToService(object, domain, service, cancellable = NULL, .errwarn = TRUE)
Arguments
service
the name of the service to connect to
.errwarn
Whether to issue a warning on error or fail silently
Details
This call looks up the SRV record for service
at domain
for the
"tcp" protocol. It then attempts to connect, in turn, to each of
the hosts providing the service until either a connection succeeds
or there are no hosts remaining.
Upon a successful connection, a new GSocketConnection
is constructed
and returned. The caller owns this new object and must drop their
reference to it when finished with it.
In the event of any failure (DNS error, service not found, no hosts
connectable) NULL
is returned and error
(if non-NULL
) is set
accordingly.