SocketAddressEnumerator.next

Retrieves the next gio.SocketAddress from enumerator. Note that this may block for some amount of time. (Eg, a gio.NetworkAddress may need to do a DNS lookup before it can return an address.) Use Socket.addressEnumeratorNextAsync if you need to avoid blocking.

If enumerator is expected to yield addresses, but for some reason is unable to (eg, because of a DNS error), then the first call to Socket.addressEnumeratorNext will return an appropriate error in *error. However, if the first call to Socket.addressEnumeratorNext succeeds, then any further internal errors (other than cancellable being triggered) will be ignored.

class SocketAddressEnumerator
next

Parameters

cancellable Cancellable

optional gio.Cancellable object, NULL to ignore.

Return Value

a gio.SocketAddress (owned by the caller), or NULL on error (in which case *error will be set) or if there are no more addresses.

Throws

GException on failure.