Synchronously performs a DNS SRV lookup for the given service
and protocol
in the given domain
and
returns an array of SrvTarget.
domain
may be an ASCII-only or UTF-8 hostname. Note also that the service
and protocol
arguments
do not include the leading underscore that appears in the actual DNS entry.
On success, lookup_service will return a non-empty List of SrvTarget, sorted in order of preference. (That is, you should attempt to connect to the first target first, then the second if the first fails, etc.)
If the DNS resolution fails, throws (if non-null) will be set to a value from ResolverError and null will be returned.
If cancellable
is non-null, it can be used to cancel the operation, in which
case throws (if non-null) will be set to
g_io_error_cancelled.
If you are planning to connect to the service, it is usually easier to create a NetworkService and use its SocketConnectable interface.
this |
a Resolver |
service |
the service type to look up (eg, "ldap") |
protocol |
the networking protocol to use for |
domain |
the DNS domain to look up the service in |
cancellable |
a Cancellable, or null |
a non-empty List of SrvTarget
, or null on error. You must free each of the targets and the list when you are
done with it. (You can use |