/docs/reference/gio/html/GSocketClient.html
HTML | 2070 lines | 2068 code | 2 blank | 0 comment | 0 complexity | a0ba2450f919f8b86a3136f1c823e639 MD5 | raw file
Possible License(s): LGPL-2.1, AGPL-3.0
Large files files are truncated, but you can click here to view the full file
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <title>GSocketClient: GIO Reference Manual</title>
- <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
- <link rel="home" href="index.html" title="GIO Reference Manual">
- <link rel="up" href="highlevel-socket.html" title="High-level network functionallity">
- <link rel="prev" href="highlevel-socket.html" title="High-level network functionallity">
- <link rel="next" href="GSocketConnection.html" title="GSocketConnection">
- <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
- <link rel="stylesheet" href="style.css" type="text/css">
- </head>
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
- <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
- <td width="100%" align="left" class="shortcuts">
- <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
- <a href="#GSocketClient.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
- <a href="#GSocketClient.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
- <a href="#GSocketClient.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
- <a href="#GSocketClient.signals" class="shortcut">Signals</a></span>
- </td>
- <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
- <td><a accesskey="u" href="highlevel-socket.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
- <td><a accesskey="p" href="highlevel-socket.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
- <td><a accesskey="n" href="GSocketConnection.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
- </tr></table>
- <div class="refentry">
- <a name="GSocketClient"></a><div class="titlepage"></div>
- <div class="refnamediv"><table width="100%"><tr>
- <td valign="top">
- <h2><span class="refentrytitle"><a name="GSocketClient.top_of_page"></a>GSocketClient</span></h2>
- <p>GSocketClient — Helper for connecting to a network service</p>
- </td>
- <td class="gallery_image" valign="top" align="right"></td>
- </tr></table></div>
- <div class="refsect1">
- <a name="GSocketClient.functions"></a><h2>Functions</h2>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="functions_return">
- <col class="functions_name">
- </colgroup>
- <tbody>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="returnvalue">GSocketClient</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-new" title="g_socket_client_new ()">g_socket_client_new</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()">g_socket_client_connect</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-async" title="g_socket_client_connect_async ()">g_socket_client_connect_async</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-finish" title="g_socket_client_connect_finish ()">g_socket_client_connect_finish</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host" title="g_socket_client_connect_to_host ()">g_socket_client_connect_to_host</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-async" title="g_socket_client_connect_to_host_async ()">g_socket_client_connect_to_host_async</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-finish" title="g_socket_client_connect_to_host_finish ()">g_socket_client_connect_to_host_finish</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service" title="g_socket_client_connect_to_service ()">g_socket_client_connect_to_service</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service-async" title="g_socket_client_connect_to_service_async ()">g_socket_client_connect_to_service_async</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-service-finish" title="g_socket_client_connect_to_service_finish ()">g_socket_client_connect_to_service_finish</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri" title="g_socket_client_connect_to_uri ()">g_socket_client_connect_to_uri</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-async" title="g_socket_client_connect_to_uri_async ()">g_socket_client_connect_to_uri_async</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-connect-to-uri-finish" title="g_socket_client_connect_to_uri_finish ()">g_socket_client_connect_to_uri_finish</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-family" title="g_socket_client_set_family ()">g_socket_client_set_family</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()">g_socket_client_set_local_address</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-protocol" title="g_socket_client_set_protocol ()">g_socket_client_set_protocol</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-socket-type" title="g_socket_client_set_socket_type ()">g_socket_client_set_socket_type</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-timeout" title="g_socket_client_set_timeout ()">g_socket_client_set_timeout</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-enable-proxy" title="g_socket_client_set_enable_proxy ()">g_socket_client_set_enable_proxy</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-proxy-resolver" title="g_socket_client_set_proxy_resolver ()">g_socket_client_set_proxy_resolver</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-tls" title="g_socket_client_set_tls ()">g_socket_client_set_tls</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-set-tls-validation-flags" title="g_socket_client_set_tls_validation_flags ()">g_socket_client_set_tls_validation_flags</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="returnvalue">GSocketFamily</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-family" title="g_socket_client_get_family ()">g_socket_client_get_family</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="returnvalue">GSocketAddress</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-local-address" title="g_socket_client_get_local_address ()">g_socket_client_get_local_address</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="returnvalue">GSocketProtocol</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-protocol" title="g_socket_client_get_protocol ()">g_socket_client_get_protocol</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="returnvalue">GSocketType</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-socket-type" title="g_socket_client_get_socket_type ()">g_socket_client_get_socket_type</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a href="../glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-timeout" title="g_socket_client_get_timeout ()">g_socket_client_get_timeout</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-enable-proxy" title="g_socket_client_get_enable_proxy ()">g_socket_client_get_enable_proxy</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="returnvalue">GProxyResolver</span></a> *
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-proxy-resolver" title="g_socket_client_get_proxy_resolver ()">g_socket_client_get_proxy_resolver</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a href="../glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-tls" title="g_socket_client_get_tls ()">g_socket_client_get_tls</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="returnvalue">GTlsCertificateFlags</span></a>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-get-tls-validation-flags" title="g_socket_client_get_tls_validation_flags ()">g_socket_client_get_tls_validation_flags</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- <tr>
- <td class="function_type">
- <span class="returnvalue">void</span>
- </td>
- <td class="function_name">
- <a class="link" href="GSocketClient.html#g-socket-client-add-application-proxy" title="g_socket_client_add_application_proxy ()">g_socket_client_add_application_proxy</a> <span class="c_punctuation">()</span>
- </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.properties"></a><h2>Properties</h2>
- <div class="informaltable"><table class="informaltable" border="0">
- <colgroup>
- <col width="150px" class="properties_type">
- <col width="300px" class="properties_name">
- <col width="200px" class="properties_flags">
- </colgroup>
- <tbody>
- <tr>
- <td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--enable-proxy" title="The “enable-proxy” property">enable-proxy</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a class="link" href="GSocketAddress.html#GSocketFamily" title="enum GSocketFamily"><span class="type">GSocketFamily</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--family" title="The “family” property">family</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type">
- <a class="link" href="GSocketAddress.html" title="GSocketAddress"><span class="type">GSocketAddress</span></a> *</td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--local-address" title="The “local-address” property">local-address</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a class="link" href="GSocket.html#GSocketProtocol" title="enum GSocketProtocol"><span class="type">GSocketProtocol</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--protocol" title="The “protocol” property">protocol</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type">
- <a class="link" href="GProxyResolver.html" title="GProxyResolver"><span class="type">GProxyResolver</span></a> *</td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--proxy-resolver" title="The “proxy-resolver” property">proxy-resolver</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a href="../glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--timeout" title="The “timeout” property">timeout</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a href="../glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--tls" title="The “tls” property">tls</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags"><span class="type">GTlsCertificateFlags</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--tls-validation-flags" title="The “tls-validation-flags” property">tls-validation-flags</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- <tr>
- <td class="property_type"><a class="link" href="GSocket.html#GSocketType" title="enum GSocketType"><span class="type">GSocketType</span></a></td>
- <td class="property_name"><a class="link" href="GSocketClient.html#GSocketClient--type" title="The “type” property">type</a></td>
- <td class="property_flags">Read / Write / Construct</td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.signals"></a><h2>Signals</h2>
- <div class="informaltable"><table class="informaltable" border="0">
- <colgroup>
- <col width="150px" class="signals_return">
- <col width="300px" class="signals_name">
- <col width="200px" class="signals_flags">
- </colgroup>
- <tbody><tr>
- <td class="signal_type"><span class="returnvalue">void</span></td>
- <td class="signal_name"><a class="link" href="GSocketClient.html#GSocketClient-event" title="The “event” signal">event</a></td>
- <td class="signal_flags"><a href="../gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
- </tr></tbody>
- </table></div>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.other"></a><h2>Types and Values</h2>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="name">
- <col class="description">
- </colgroup>
- <tbody>
- <tr>
- <td class="datatype_keyword"> </td>
- <td class="function_name"><a class="link" href="GSocketClient.html#GSocketClient-struct" title="GSocketClient">GSocketClient</a></td>
- </tr>
- <tr>
- <td class="datatype_keyword">enum</td>
- <td class="function_name"><a class="link" href="GSocketClient.html#GSocketClientEvent" title="enum GSocketClientEvent">GSocketClientEvent</a></td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
- <pre class="screen"> <a href="../gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
- <span class="lineart">╰──</span> GSocketClient
- </pre>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.includes"></a><h2>Includes</h2>
- <pre class="synopsis">#include <gio/gio.h>
- </pre>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.description"></a><h2>Description</h2>
- <p><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> is a lightweight high-level utility class for connecting to
- a network host using a connection oriented socket type.</p>
- <p>You create a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> object, set any options you want, and then
- call a sync or async connect operation, which returns a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a>
- subclass on success.</p>
- <p>The type of the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> object returned depends on the type of
- the underlying socket that is in use. For instance, for a TCP/IP connection
- it will be a <a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a>.</p>
- <p>As <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> is a lightweight object, you don't need to cache it. You
- can just create a new one any time you need one.</p>
- </div>
- <div class="refsect1">
- <a name="GSocketClient.functions_details"></a><h2>Functions</h2>
- <div class="refsect2">
- <a name="g-socket-client-new"></a><h3>g_socket_client_new ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="returnvalue">GSocketClient</span></a> *
- g_socket_client_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
- <p>Creates a new <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> with the default options.</p>
- <div class="refsect3">
- <a name="g-socket-client-new.returns"></a><h4>Returns</h4>
- <p> a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.
- Free the returned object with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect"></a><h3>g_socket_client_connect ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- g_socket_client_connect (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *connectable</code></em>,
- <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
- <p>Tries to resolve the <em class="parameter"><code>connectable</code></em>
- and make a network connection to it.</p>
- <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
- and returned. The caller owns this new object and must drop their
- reference to it when finished with it.</p>
- <p>The type of the <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> object returned depends on the type of
- the underlying socket that is used. For instance, for a TCP/IP connection
- it will be a <a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a>.</p>
- <p>The socket created will be the same family as the address that the
- <em class="parameter"><code>connectable</code></em>
- resolves to, unless family is set with <a class="link" href="GSocketClient.html#g-socket-client-set-family" title="g_socket_client_set_family ()"><code class="function">g_socket_client_set_family()</code></a>
- or indirectly via <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()"><code class="function">g_socket_client_set_local_address()</code></a>. The socket type
- defaults to <a class="link" href="GSocket.html#G-SOCKET-TYPE-STREAM:CAPS"><code class="literal">G_SOCKET_TYPE_STREAM</code></a> but can be set with
- <a class="link" href="GSocketClient.html#g-socket-client-set-socket-type" title="g_socket_client_set_socket_type ()"><code class="function">g_socket_client_set_socket_type()</code></a>.</p>
- <p>If a local address is specified with <a class="link" href="GSocketClient.html#g-socket-client-set-local-address" title="g_socket_client_set_local_address ()"><code class="function">g_socket_client_set_local_address()</code></a> the
- socket will be bound to this address before connecting.</p>
- <div class="refsect3">
- <a name="g-socket-client-connect.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>connectable</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> specifying the remote address.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>cancellable</p></td>
- <td class="parameter_description"><p> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>error</p></td>
- <td class="parameter_description"><p><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> for error reporting, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect3">
- <a name="g-socket-client-connect.returns"></a><h4>Returns</h4>
- <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-async"></a><h3>g_socket_client_connect_async ()</h3>
- <pre class="programlisting"><span class="returnvalue">void</span>
- g_socket_client_connect_async (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> *connectable</code></em>,
- <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
- <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
- <p>This is the asynchronous version of <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>.</p>
- <p>When the operation is finished <em class="parameter"><code>callback</code></em>
- will be
- called. You can then call <a class="link" href="GSocketClient.html#g-socket-client-connect-finish" title="g_socket_client_connect_finish ()"><code class="function">g_socket_client_connect_finish()</code></a> to get
- the result of the operation.</p>
- <div class="refsect3">
- <a name="g-socket-client-connect-async.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>connectable</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketConnectable.html" title="GSocketConnectable"><span class="type">GSocketConnectable</span></a> specifying the remote address.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>cancellable</p></td>
- <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>callback</p></td>
- <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>user_data</p></td>
- <td class="parameter_description"><p> user data for the callback. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-finish"></a><h3>g_socket_client_connect_finish ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- g_socket_client_connect_finish (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
- <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
- <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-async" title="g_socket_client_connect_async ()"><code class="function">g_socket_client_connect_async()</code></a></p>
- <div class="refsect3">
- <a name="g-socket-client-connect-finish.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>result</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>error</p></td>
- <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
- ignore.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect3">
- <a name="g-socket-client-connect-finish.returns"></a><h4>Returns</h4>
- <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-to-host"></a><h3>g_socket_client_connect_to_host ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- g_socket_client_connect_to_host (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host_and_port</code></em>,
- <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
- <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
- <p>This is a helper function for <a class="link" href="GSocketClient.html#g-socket-client-connect" title="g_socket_client_connect ()"><code class="function">g_socket_client_connect()</code></a>.</p>
- <p>Attempts to create a TCP connection to the named host.</p>
- <p><em class="parameter"><code>host_and_port</code></em>
- may be in any of a number of recognized formats; an IPv6
- address, an IPv4 address, or a domain name (in which case a DNS
- lookup is performed). Quoting with [] is supported for all address
- types. A port override may be specified in the usual way with a
- colon. Ports may be given as decimal numbers or symbolic names (in
- which case an /etc/services lookup is performed).</p>
- <p>If no port override is given in <em class="parameter"><code>host_and_port</code></em>
- then <em class="parameter"><code>default_port</code></em>
- will be
- used as the port number to connect to.</p>
- <p>In general, <em class="parameter"><code>host_and_port</code></em>
- is expected to be provided by the user (allowing
- them to give the hostname, and a port override if necessary) and
- <em class="parameter"><code>default_port</code></em>
- is expected to be provided by the application.</p>
- <p>In the case that an IP address is given, a single connection
- attempt is made. In the case that a name is given, multiple
- connection attempts may be made, in turn and according to the
- number of address records in DNS, until a connection succeeds.</p>
- <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
- and returned. The caller owns this new object and must drop their
- reference to it when finished with it.</p>
- <p>In the event of any failure (DNS error, service not found, no hosts
- connectable) <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
- (if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) is set
- accordingly.</p>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-host.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>host_and_port</p></td>
- <td class="parameter_description"><p>the name and optionally port of the host to connect to</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>default_port</p></td>
- <td class="parameter_description"><p>the default port to connect to</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>cancellable</p></td>
- <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>error</p></td>
- <td class="parameter_description"><p>a pointer to a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-host.returns"></a><h4>Returns</h4>
- <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-to-host-async"></a><h3>g_socket_client_connect_to_host_async ()</h3>
- <pre class="programlisting"><span class="returnvalue">void</span>
- g_socket_client_connect_to_host_async (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *host_and_port</code></em>,
- <em class="parameter"><code><a href="../glib-Basic-Types.html#guint16"><span class="type">guint16</span></a> default_port</code></em>,
- <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
- <em class="parameter"><code><a href="../glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
- <p>This is the asynchronous version of <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host" title="g_socket_client_connect_to_host ()"><code class="function">g_socket_client_connect_to_host()</code></a>.</p>
- <p>When the operation is finished <em class="parameter"><code>callback</code></em>
- will be
- called. You can then call <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-finish" title="g_socket_client_connect_to_host_finish ()"><code class="function">g_socket_client_connect_to_host_finish()</code></a> to get
- the result of the operation.</p>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-host-async.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a></p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>host_and_port</p></td>
- <td class="parameter_description"><p>the name and optionally the port of the host to connect to</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>default_port</p></td>
- <td class="parameter_description"><p>the default port to connect to</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>cancellable</p></td>
- <td class="parameter_description"><p> a <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>callback</p></td>
- <td class="parameter_description"><p> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
- </tr>
- <tr>
- <td class="parameter_name"><p>user_data</p></td>
- <td class="parameter_description"><p> user data for the callback. </p></td>
- <td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-to-host-finish"></a><h3>g_socket_client_connect_to_host_finish ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- g_socket_client_connect_to_host_finish
- (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code><a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> *result</code></em>,
- <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
- <p>Finishes an async connect operation. See <a class="link" href="GSocketClient.html#g-socket-client-connect-to-host-async" title="g_socket_client_connect_to_host_async ()"><code class="function">g_socket_client_connect_to_host_async()</code></a></p>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-host-finish.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a>.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>result</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- <tr>
- <td class="parameter_name"><p>error</p></td>
- <td class="parameter_description"><p>a <a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occurring, or <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
- ignore.</p></td>
- <td class="parameter_annotations"> </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-host-finish.returns"></a><h4>Returns</h4>
- <p> a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> on success, <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
- </div>
- <p class="since">Since: <a class="link" href="api-index-2-22.html#api-index-2.22">2.22</a></p>
- </div>
- <hr>
- <div class="refsect2">
- <a name="g-socket-client-connect-to-service"></a><h3>g_socket_client_connect_to_service ()</h3>
- <pre class="programlisting"><a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="returnvalue">GSocketConnection</span></a> *
- g_socket_client_connect_to_service (<em class="parameter"><code><a class="link" href="GSocketClient.html" title="GSocketClient"><span class="type">GSocketClient</span></a> *client</code></em>,
- <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *domain</code></em>,
- <em class="parameter"><code>const <a href="../glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *service</code></em>,
- <em class="parameter"><code><a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> *cancellable</code></em>,
- <em class="parameter"><code><a href="../glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
- <p>Attempts to create a TCP connection to a service.</p>
- <p>This call looks up the SRV record for <em class="parameter"><code>service</code></em>
- at <em class="parameter"><code>domain</code></em>
- for the
- "tcp" protocol. It then attempts to connect, in turn, to each of
- the hosts providing the service until either a connection succeeds
- or there are no hosts remaining.</p>
- <p>Upon a successful connection, a new <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSocketConnection</span></a> is constructed
- and returned. The caller owns this new object and must drop their
- reference to it when finished with it.</p>
- <p>In the event of any failure (DNS error, service not found, no hosts
- connectable) <a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned and <em class="parameter"><code>error</code></em>
- (if non-<a href="../glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) is set
- accordingly.</p>
- <div class="refsect3">
- <a name="g-socket-client-connect-to-service.parameters"></a><h4>Parameters</h4>
- <div class="informaltable"><table class="informaltable" width="100%" border="0">
- <colgroup>
- <col width="150px" class="parameters_name">
- <col class="parameters_description">
- <col width="200px" class="parameters_annotations">
- </colgroup>
- <tbody>
- <tr>
- <td class="parameter_name"><p>client</p></td>
- <td class="parameter_description"><p>a <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span class="type">GSo…
Large files files are truncated, but you can click here to view the full file