Method
GioSocketListeneraccept
since: 2.22
Declaration
GSocketConnection*
g_socket_listener_accept (
GSocketListener* listener,
GObject** source_object,
GCancellable* cancellable,
GError** error
)
Description
Blocks waiting for a client to connect to any of the sockets added
to the listener. Returns a GSocketConnection for the socket that was accepted.
If source_object is not NULL it will be filled out with the source
object specified when the corresponding socket or address was added
to the listener.
If cancellable is not NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error G_IO_ERROR_CANCELLED will be returned.
Available since: 2.22
Parameters
source_object-
Type:
GObjectLocation where
GObjectpointer will be stored, orNULL.The argument will be set by the function. The argument can be set to NULLby the method.The argument can be NULL.The returned data is owned by the instance. cancellable-
Type:
GCancellableOptional
GCancellableobject,NULLto ignore.The argument can be NULL.The data is owned by the caller of the method. 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 aNULLGError*.The argument will be left initialized to NULLby the method 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: GSocketConnection
A GSocketConnection on success, NULL on error.
| The caller of the method takes ownership of the returned data, and is responsible for freeing it. |