Function

Purplesocket_listener_add_any_inet_port

Declaration [src]

guint16
purple_socket_listener_add_any_inet_port (
  GSocketListener* listener,
  GObject* source_object,
  GError** error
)

Description [src]

Listens for TCP connections on any available port number for both IPv6 and IPv4 (if each is available). This is a simple wrapper around g_socket_listener_add_any_inet_port(), except if the user specified a port range in the settings, than a port will be chosen from that range.

Parameters

listener

Type: GSocketListener

A GSocketListener.

The data is owned by the caller of the function.

source_object

Type: GObject

Optional GObject identifying this source.

The argument can be NULL.

The data is owned by the caller of the function.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.

If the return location is not NULL, then you must initialize it to a NULL GError*.

The argument will left initialized to NULL by the function if there are no errors.

In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: guint16

The port number, or 0 in case of failure.