hostname
to determine its associated IP
address(es). hostname
may be an ASCII-only or UTF-8 hostname, or
the textual form of an IP address (in which case this just becomes
a wrapper around gInetAddressNewFromString
).gResolverLookupByName(object, hostname, cancellable = NULL, .errwarn = TRUE)
object
hostname
cancellable
GCancellable
, or NULL
list
of GInetAddress
, or NULL
on error. You
must unref each of the addresses and free the list when you are
done with it. (You can use gResolverFreeAddresses
to do this.)error
GError
, or NULL
gResolverLookupByName
will return a list
of
GInetAddress
, sorted in order of preference. (That is, you should
attempt to connect to the first address first, then the second if
the first fails, etc.)
If the DNS resolution fails, error
(if non-NULL
) will be set to a
value from GResolverError
.
If cancellable
is non-NULL
, it can be used to cancel the
operation, in which case error
(if non-NULL
) will be set to
G_IO_ERROR_CANCELLED
.
If you are planning to connect to a socket on the resolved IP
address, it may be easier to create a GNetworkAddress
and use its
GSocketConnectable
interface.
Since 2.22