SocketClient.connect

Tries to resolve the connectable and make a network connection to it.

Upon a successful connection, a new gio.SocketConnection is constructed and returned. The caller owns this new object and must drop their reference to it when finished with it.

The type of the gio.SocketConnection object returned depends on the type of the underlying socket that is used. For instance, for a TCP/IP connection it will be a gio.TcpConnection

The socket created will be the same family as the address that the connectable resolves to, unless family is set with Socket.clientSetFamily or indirectly via Socket.clientSetLocalAddress. The socket type defaults to G_SOCKET_TYPE_STREAM but can be set with Socket.clientSetSocketType.

If a local address is specified with Socket.clientSetLocalAddress the socket will be bound to this address before connecting.

Parameters

connectable SocketConnectableIF

a GSocketConnectable specifying the remote address.

cancellable Cancellable

optional gio.Cancellable object, NULL to ignore.

Return Value

a gio.SocketConnection on success, NULL on error.

Throws

GException on failure.

Meta

Since

2.22