Method

GioProxyResolverlookup

Declaration

gchar**
g_proxy_resolver_lookup (
  GProxyResolver* resolver,
  const gchar* uri,
  GCancellable* cancellable,
  GError** error
)

Description

Looks into the system proxy configuration to determine what proxy, if any, to use to connect to uri. The returned proxy URIs are of the form <protocol>://[user[:password]@]host:port or direct://, where could be http, rtsp, socks or other proxying protocol.

If you don’t know what network protocol is being used on the socket, you should use none as the URI protocol. In this case, the resolver might still return a generic proxy type (such as SOCKS), but would not return protocol-specific proxy types (such as http).

direct:// is used when no proxy is needed. Direct connection should not be attempted unless it is part of the returned array of proxies.

Available since:2.26

Parameters

uri const gchar*
 

A URI representing the destination to connect to.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
cancellable GCancellable
 

A GCancellable, or NULL.

 The argument can be NULL.
 The data is owned by the caller of the function.
error GError **
  The return location for a GError*, or NULL.

Return value

Returns: An array of utf8
 

A NULL-terminated array of proxy URIs. Must be freed with g_strfreev().

 The array is NULL-terminated.
 The caller of the method takes ownership of the data, and is responsible for freeing it.
 Each element is a NUL terminated UTF-8 string.