|
Packit |
ae235b |
|
|
Packit |
ae235b |
<html>
|
|
Packit |
ae235b |
<head>
|
|
Packit |
ae235b |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit |
ae235b |
<title>GSocketAddressEnumerator: GIO Reference Manual</title>
|
|
Packit |
ae235b |
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
|
Packit |
ae235b |
<link rel="home" href="index.html" title="GIO Reference Manual">
|
|
Packit |
ae235b |
<link rel="up" href="resolver.html" title="DNS resolution">
|
|
Packit |
ae235b |
<link rel="prev" href="GSocketConnectable.html" title="GSocketConnectable">
|
|
Packit |
ae235b |
<link rel="next" href="GProxyAddressEnumerator.html" title="GProxyAddressEnumerator">
|
|
Packit |
ae235b |
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
|
Packit |
ae235b |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit |
ae235b |
</head>
|
|
Packit |
ae235b |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Top |
|
|
Packit |
ae235b |
Description |
|
|
Packit |
ae235b |
Object Hierarchy
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddressEnumerator
|
|
Packit |
ae235b |
GSocketAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddress *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_async ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddress *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_finish ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
struct
|
|
Packit |
ae235b |
GSocketAddressEnumeratorClass
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Object Hierarchy
|
|
Packit |
ae235b |
GObject
|
|
Packit |
ae235b |
╰── GSocketAddressEnumerator
|
|
Packit |
ae235b |
╰── GProxyAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Description
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next ()
|
|
Packit |
ae235b |
GSocketAddress *
|
|
Packit |
ae235b |
g_socket_address_enumerator_next (GSocketAddressEnumerator *enumerator ,
|
|
Packit |
ae235b |
GCancellable *cancellable ,
|
|
Packit |
ae235b |
GError **error );
|
|
Packit |
ae235b |
Retrieves the next GSocketAddress from enumerator
|
|
Packit |
ae235b |
. Note that this
|
|
Packit |
ae235b |
may block for some amount of time. (Eg, a GNetworkAddress may need
|
|
Packit |
ae235b |
to do a DNS lookup before it can return an address.) Use
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_async() if you need to avoid
|
|
Packit |
ae235b |
blocking.
|
|
Packit |
ae235b |
If enumerator
|
|
Packit |
ae235b |
is expected to yield addresses, but for some reason
|
|
Packit |
ae235b |
is unable to (eg, because of a DNS error), then the first call to
|
|
Packit |
ae235b |
g_socket_address_enumerator_next() will return an appropriate error
|
|
Packit |
ae235b |
in *error
|
|
Packit |
ae235b |
. However, if the first call to
|
|
Packit |
ae235b |
g_socket_address_enumerator_next() succeeds, then any further
|
|
Packit |
ae235b |
internal errors (other than cancellable
|
|
Packit |
ae235b |
being triggered) will be
|
|
Packit |
ae235b |
ignored.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enumerator
|
|
Packit |
ae235b |
a GSocketAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
cancellable
|
|
Packit |
ae235b |
optional GCancellable object, NULL to ignore.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a GSocketAddress (owned by the caller), or NULL on
|
|
Packit |
ae235b |
error (in which case *error
|
|
Packit |
ae235b |
will be set) or if there are no
|
|
Packit |
ae235b |
more addresses.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_async ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_async
|
|
Packit |
ae235b |
(GSocketAddressEnumerator *enumerator ,
|
|
Packit |
ae235b |
GCancellable *cancellable ,
|
|
Packit |
ae235b |
GAsyncReadyCallback callback ,
|
|
Packit |
ae235b |
gpointer user_data );
|
|
Packit |
ae235b |
Asynchronously retrieves the next GSocketAddress from enumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
and then calls callback
|
|
Packit |
ae235b |
, which must call
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_finish() to get the result.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enumerator
|
|
Packit |
ae235b |
a GSocketAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
cancellable
|
|
Packit |
ae235b |
optional GCancellable object, NULL to ignore.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
callback
|
|
Packit |
ae235b |
a GAsyncReadyCallback to call when the request
|
|
Packit |
ae235b |
is satisfied.
|
|
Packit |
ae235b |
[scope async]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
user_data
|
|
Packit |
ae235b |
the data to pass to callback function.
|
|
Packit |
ae235b |
[closure]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_finish ()
|
|
Packit |
ae235b |
GSocketAddress *
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_finish
|
|
Packit |
ae235b |
(GSocketAddressEnumerator *enumerator ,
|
|
Packit |
ae235b |
GAsyncResult *result ,
|
|
Packit |
ae235b |
GError **error );
|
|
Packit |
ae235b |
Retrieves the result of a completed call to
|
|
Packit |
ae235b |
g_socket_address_enumerator_next_async() . See
|
|
Packit |
ae235b |
g_socket_address_enumerator_next() for more information about
|
|
Packit |
ae235b |
error handling.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enumerator
|
|
Packit |
ae235b |
a GSocketAddressEnumerator
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
result
|
|
Packit |
ae235b |
a GAsyncResult
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a GSocketAddress (owned by the caller), or NULL on
|
|
Packit |
ae235b |
error (in which case *error
|
|
Packit |
ae235b |
will be set) or if there are no
|
|
Packit |
ae235b |
more addresses.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddressEnumerator
|
|
Packit |
ae235b |
typedef struct _GSocketAddressEnumerator GSocketAddressEnumerator;
|
|
Packit |
ae235b |
Enumerator type for objects that contain or generate
|
|
Packit |
ae235b |
GSocketAddress instances.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
struct GSocketAddressEnumeratorClass
|
|
Packit |
ae235b |
struct GSocketAddressEnumeratorClass {
|
|
Packit |
ae235b |
GObjectClass parent_class;
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/* Virtual Table */
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GSocketAddress * (* next) (GSocketAddressEnumerator *enumerator,
|
|
Packit |
ae235b |
GCancellable *cancellable,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void (* next_async) (GSocketAddressEnumerator *enumerator,
|
|
Packit |
ae235b |
GCancellable *cancellable,
|
|
Packit |
ae235b |
GAsyncReadyCallback callback,
|
|
Packit |
ae235b |
gpointer user_data);
|
|
Packit |
ae235b |
GSocketAddress * (* next_finish) (GSocketAddressEnumerator *enumerator,
|
|
Packit |
ae235b |
GAsyncResult *result,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
};
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Generated by GTK-Doc V1.27
|
|
Packit |
ae235b |
</body>
|
|
Packit |
ae235b |
</html>
|