Add gobject introspection
[profile/ivi/GSSDP.git] / doc / html / GSSDPClient.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GSSDPClient</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GSSDP Reference Manual">
8 <link rel="up" href="ch01.html" title="GSSDP">
9 <link rel="prev" href="ch01.html" title="GSSDP">
10 <link rel="next" href="GSSDPResourceBrowser.html" title="GSSDPResourceBrowser">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GSSDP Reference Manual</th>
21 <td><a accesskey="n" href="GSSDPResourceBrowser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GSSDPClient.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#GSSDPClient.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#GSSDPClient.object-hierarchy" class="shortcut">Object Hierarchy</a>
29                    | 
30                   <a href="#GSSDPClient.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
31                    | 
32                   <a href="#GSSDPClient.properties" class="shortcut">Properties</a>
33                    | 
34                   <a href="#GSSDPClient.signals" class="shortcut">Signals</a>
35 </td></tr>
36 </table>
37 <div class="refentry">
38 <a name="GSSDPClient"></a><div class="titlepage"></div>
39 <div class="refnamediv"><table width="100%"><tr>
40 <td valign="top">
41 <h2><span class="refentrytitle"><a name="GSSDPClient.top_of_page"></a>GSSDPClient</span></h2>
42 <p>GSSDPClient — SSDP "bus" wrapper.</p>
43 </td>
44 <td valign="top" align="right"></td>
45 </tr></table></div>
46 <div class="refsynopsisdiv">
47 <a name="GSSDPClient.synopsis"></a><h2>Synopsis</h2>
48 <pre class="synopsis">struct              <a class="link" href="GSSDPClient.html#GSSDPClient-struct" title="struct GSSDPClient">GSSDPClient</a>;
49 <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="returnvalue">GSSDPClient</span></a> *       <a class="link" href="GSSDPClient.html#gssdp-client-new" title="gssdp_client_new ()">gssdp_client_new</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *main_context</code></em>,
50                                                          <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>,
51                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
52 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="returnvalue">GMainContext</span></a> *      <a class="link" href="GSSDPClient.html#gssdp-client-get-main-context" title="gssdp_client_get_main_context ()">gssdp_client_get_main_context</a>       (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
53 <span class="returnvalue">void</span>                <a class="link" href="GSSDPClient.html#gssdp-client-set-server-id" title="gssdp_client_set_server_id ()">gssdp_client_set_server_id</a>          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>,
54                                                          <em class="parameter"><code>const <span class="type">char</span> *server_id</code></em>);
55 const <span class="returnvalue">char</span> *        <a class="link" href="GSSDPClient.html#gssdp-client-get-server-id" title="gssdp_client_get_server_id ()">gssdp_client_get_server_id</a>          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
56 const <span class="returnvalue">char</span> *        <a class="link" href="GSSDPClient.html#gssdp-client-get-interface" title="gssdp_client_get_interface ()">gssdp_client_get_interface</a>          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
57 const <span class="returnvalue">char</span> *        <a class="link" href="GSSDPClient.html#gssdp-client-get-host-ip" title="gssdp_client_get_host_ip ()">gssdp_client_get_host_ip</a>            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
58 <span class="returnvalue">void</span>                <a class="link" href="GSSDPClient.html#gssdp-client-set-network" title="gssdp_client_set_network ()">gssdp_client_set_network</a>            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>,
59                                                          <em class="parameter"><code>const <span class="type">char</span> *network</code></em>);
60 const <span class="returnvalue">char</span> *        <a class="link" href="GSSDPClient.html#gssdp-client-get-network" title="gssdp_client_get_network ()">gssdp_client_get_network</a>            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
61 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GSSDPClient.html#gssdp-client-get-active" title="gssdp_client_get_active ()">gssdp_client_get_active</a>             (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);
62 </pre>
63 </div>
64 <div class="refsect1">
65 <a name="GSSDPClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
66 <pre class="synopsis">
67   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
68    +----GSSDPClient
69 </pre>
70 </div>
71 <div class="refsect1">
72 <a name="GSSDPClient.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
73 <p>
74 GSSDPClient implements
75  <a href="http://library.gnome.org/devel/gio/unstable/GInitable.html">GInitable</a>.</p>
76 </div>
77 <div class="refsect1">
78 <a name="GSSDPClient.properties"></a><h2>Properties</h2>
79 <pre class="synopsis">
80   "<a class="link" href="GSSDPClient.html#GSSDPClient--active" title='The "active" property'>active</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
81   "<a class="link" href="GSSDPClient.html#GSSDPClient--host-ip" title='The "host-ip" property'>host-ip</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read
82   "<a class="link" href="GSSDPClient.html#GSSDPClient--interface" title='The "interface" property'>interface</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct Only
83   "<a class="link" href="GSSDPClient.html#GSSDPClient--main-context" title='The "main-context" property'>main-context</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only
84   "<a class="link" href="GSSDPClient.html#GSSDPClient--network" title='The "network" property'>network</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct
85   "<a class="link" href="GSSDPClient.html#GSSDPClient--server-id" title='The "server-id" property'>server-id</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
86   "<a class="link" href="GSSDPClient.html#GSSDPClient--socket-ttl" title='The "socket-ttl" property'>socket-ttl</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write / Construct Only
87 </pre>
88 </div>
89 <div class="refsect1">
90 <a name="GSSDPClient.signals"></a><h2>Signals</h2>
91 <pre class="synopsis">
92   "<a class="link" href="GSSDPClient.html#GSSDPClient-message-received" title='The "message-received" signal'>message-received</a>"                               : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
93 </pre>
94 </div>
95 <div class="refsect1">
96 <a name="GSSDPClient.description"></a><h2>Description</h2>
97 <p>
98 <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> wraps the SSDP "bus" as used by both <a class="link" href="GSSDPResourceBrowser.html" title="GSSDPResourceBrowser"><span class="type">GSSDPResourceBrowser</span></a>
99 and <a class="link" href="GSSDPResourceGroup.html" title="GSSDPResourceGroup"><span class="type">GSSDPResourceGroup</span></a>.
100 </p>
101 </div>
102 <div class="refsect1">
103 <a name="GSSDPClient.details"></a><h2>Details</h2>
104 <div class="refsect2">
105 <a name="GSSDPClient-struct"></a><h3>struct GSSDPClient</h3>
106 <pre class="programlisting">struct GSSDPClient;</pre>
107 <p>
108 </p>
109 </div>
110 <hr>
111 <div class="refsect2">
112 <a name="gssdp-client-new"></a><h3>gssdp_client_new ()</h3>
113 <pre class="programlisting"><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="returnvalue">GSSDPClient</span></a> *       gssdp_client_new                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> *main_context</code></em>,
114                                                          <em class="parameter"><code>const <span class="type">char</span> *iface</code></em>,
115                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
116 <div class="variablelist"><table border="0">
117 <col align="left" valign="top">
118 <tbody>
119 <tr>
120 <td><p><span class="term"><em class="parameter"><code>main_context</code></em> :</span></p></td>
121 <td>Deprecated: 0.11.2: Always set to NULL. If you want to
122 specify a context use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default"><code class="function">g_main_context_push_thread_default()</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
123 </td>
124 </tr>
125 <tr>
126 <td><p><span class="term"><em class="parameter"><code>iface</code></em> :</span></p></td>
127 <td>The name of the network interface, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for auto-detection.</td>
128 </tr>
129 <tr>
130 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
131 <td>Location to store error, or NULL</td>
132 </tr>
133 <tr>
134 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
135 <td>A new <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> object.</td>
136 </tr>
137 </tbody>
138 </table></div>
139 </div>
140 <hr>
141 <div class="refsect2">
142 <a name="gssdp-client-get-main-context"></a><h3>gssdp_client_get_main_context ()</h3>
143 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="returnvalue">GMainContext</span></a> *      gssdp_client_get_main_context       (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
144 <p>
145 </p>
146 </div>
147 <hr>
148 <div class="refsect2">
149 <a name="gssdp-client-set-server-id"></a><h3>gssdp_client_set_server_id ()</h3>
150 <pre class="programlisting"><span class="returnvalue">void</span>                gssdp_client_set_server_id          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>,
151                                                          <em class="parameter"><code>const <span class="type">char</span> *server_id</code></em>);</pre>
152 <p>
153 Sets the server ID of <em class="parameter"><code>client</code></em> to <em class="parameter"><code>server_id</code></em>.
154 </p>
155 <div class="variablelist"><table border="0">
156 <col align="left" valign="top">
157 <tbody>
158 <tr>
159 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
160 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
161 </td>
162 </tr>
163 <tr>
164 <td><p><span class="term"><em class="parameter"><code>server_id</code></em> :</span></p></td>
165 <td>The server ID</td>
166 </tr>
167 </tbody>
168 </table></div>
169 </div>
170 <hr>
171 <div class="refsect2">
172 <a name="gssdp-client-get-server-id"></a><h3>gssdp_client_get_server_id ()</h3>
173 <pre class="programlisting">const <span class="returnvalue">char</span> *        gssdp_client_get_server_id          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
174 <div class="variablelist"><table border="0">
175 <col align="left" valign="top">
176 <tbody>
177 <tr>
178 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
179 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
180 </td>
181 </tr>
182 <tr>
183 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
184 <td>The server ID.</td>
185 </tr>
186 </tbody>
187 </table></div>
188 </div>
189 <hr>
190 <div class="refsect2">
191 <a name="gssdp-client-get-interface"></a><h3>gssdp_client_get_interface ()</h3>
192 <pre class="programlisting">const <span class="returnvalue">char</span> *        gssdp_client_get_interface          (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
193 <p>
194 Get the name of the network interface associated to <em class="parameter"><code>client</code></em>.
195 </p>
196 <div class="variablelist"><table border="0">
197 <col align="left" valign="top">
198 <tbody>
199 <tr>
200 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
201 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
202 </td>
203 </tr>
204 <tr>
205 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
206 <td>The network interface name. This string should not be freed.</td>
207 </tr>
208 </tbody>
209 </table></div>
210 </div>
211 <hr>
212 <div class="refsect2">
213 <a name="gssdp-client-get-host-ip"></a><h3>gssdp_client_get_host_ip ()</h3>
214 <pre class="programlisting">const <span class="returnvalue">char</span> *        gssdp_client_get_host_ip            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
215 <p>
216 Get the IP address we advertise ourselves as using.
217 </p>
218 <div class="variablelist"><table border="0">
219 <col align="left" valign="top">
220 <tbody>
221 <tr>
222 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
223 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
224 </td>
225 </tr>
226 <tr>
227 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
228 <td>The IP address. This string should not be freed.</td>
229 </tr>
230 </tbody>
231 </table></div>
232 </div>
233 <hr>
234 <div class="refsect2">
235 <a name="gssdp-client-set-network"></a><h3>gssdp_client_set_network ()</h3>
236 <pre class="programlisting"><span class="returnvalue">void</span>                gssdp_client_set_network            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>,
237                                                          <em class="parameter"><code>const <span class="type">char</span> *network</code></em>);</pre>
238 <p>
239 Sets the network identification of <em class="parameter"><code>client</code></em> to <em class="parameter"><code>network</code></em>.
240 </p>
241 <div class="variablelist"><table border="0">
242 <col align="left" valign="top">
243 <tbody>
244 <tr>
245 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
246 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
247 </td>
248 </tr>
249 <tr>
250 <td><p><span class="term"><em class="parameter"><code>network</code></em> :</span></p></td>
251 <td>The string identifying the network</td>
252 </tr>
253 </tbody>
254 </table></div>
255 </div>
256 <hr>
257 <div class="refsect2">
258 <a name="gssdp-client-get-network"></a><h3>gssdp_client_get_network ()</h3>
259 <pre class="programlisting">const <span class="returnvalue">char</span> *        gssdp_client_get_network            (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
260 <p>
261 Get the network this client is associated with.
262 </p>
263 <div class="variablelist"><table border="0">
264 <col align="left" valign="top">
265 <tbody>
266 <tr>
267 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
268 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
269 </td>
270 </tr>
271 <tr>
272 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
273 <td>The network identification. This string should not be freed.</td>
274 </tr>
275 </tbody>
276 </table></div>
277 </div>
278 <hr>
279 <div class="refsect2">
280 <a name="gssdp-client-get-active"></a><h3>gssdp_client_get_active ()</h3>
281 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gssdp_client_get_active             (<em class="parameter"><code><a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *client</code></em>);</pre>
282 <div class="variablelist"><table border="0">
283 <col align="left" valign="top">
284 <tbody>
285 <tr>
286 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
287 <td>A <a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a>
288 </td>
289 </tr>
290 <tr>
291 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
292 <td>
293 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>client</code></em> is active, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
294 </tr>
295 </tbody>
296 </table></div>
297 </div>
298 </div>
299 <div class="refsect1">
300 <a name="GSSDPClient.property-details"></a><h2>Property Details</h2>
301 <div class="refsect2">
302 <a name="GSSDPClient--active"></a><h3>The <code class="literal">"active"</code> property</h3>
303 <pre class="programlisting">  "active"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
304 <p>
305 Whether this client is active or not (passive). When active
306 (default), the client sends messages on the network, otherwise
307 not. In most cases, you don't want to touch this property.
308 </p>
309 <p>Default value: TRUE</p>
310 </div>
311 <hr>
312 <div class="refsect2">
313 <a name="GSSDPClient--host-ip"></a><h3>The <code class="literal">"host-ip"</code> property</h3>
314 <pre class="programlisting">  "host-ip"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read</pre>
315 <p>
316 The IP address of the assoicated network interface.
317 </p>
318 <p>Default value: NULL</p>
319 </div>
320 <hr>
321 <div class="refsect2">
322 <a name="GSSDPClient--interface"></a><h3>The <code class="literal">"interface"</code> property</h3>
323 <pre class="programlisting">  "interface"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct Only</pre>
324 <p>
325 The name of the network interface this client is associated with.
326 Set to NULL to autodetect.
327 </p>
328 <p>Default value: NULL</p>
329 </div>
330 <hr>
331 <div class="refsect2">
332 <a name="GSSDPClient--main-context"></a><h3>The <code class="literal">"main-context"</code> property</h3>
333 <pre class="programlisting">  "main-context"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only</pre>
334 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
335 <h3 class="title">Warning</h3>
336 <p><code class="literal">GSSDPClient:main-context</code> has been deprecated since version 0.11.2 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default"><code class="function">g_main_context_push_thread_default()</code></a>.</p>
337 </div>
338 <p>
339 The <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainContext"><span class="type">GMainContext</span></a> to use. Set to NULL to use the default.
340 </p>
341 </div>
342 <hr>
343 <div class="refsect2">
344 <a name="GSSDPClient--network"></a><h3>The <code class="literal">"network"</code> property</h3>
345 <pre class="programlisting">  "network"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write / Construct</pre>
346 <p>
347 The network this client is currently connected to. You could set this
348 to anything you want to identify the network this client is
349 associated with. If you are using <span class="type">GUPnPContextManager</span> and associated
350 interface is a WiFi interface, this property is set to the ESSID of
351 the network. Otherwise, expect this to be the network IP address by
352 default.
353 </p>
354 <p>Default value: NULL</p>
355 </div>
356 <hr>
357 <div class="refsect2">
358 <a name="GSSDPClient--server-id"></a><h3>The <code class="literal">"server-id"</code> property</h3>
359 <pre class="programlisting">  "server-id"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
360 <p>
361 The SSDP server's identifier.
362 </p>
363 <p>Default value: NULL</p>
364 </div>
365 <hr>
366 <div class="refsect2">
367 <a name="GSSDPClient--socket-ttl"></a><h3>The <code class="literal">"socket-ttl"</code> property</h3>
368 <pre class="programlisting">  "socket-ttl"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write / Construct Only</pre>
369 <p>
370 Time-to-live value to use for all sockets created by this client.
371 If not set (or set to 0) the value recommended by UPnP will be used.
372 This property can only be set during object construction.
373 </p>
374 <p>Allowed values: &lt;= 255</p>
375 <p>Default value: 0</p>
376 </div>
377 </div>
378 <div class="refsect1">
379 <a name="GSSDPClient.signal-details"></a><h2>Signal Details</h2>
380 <div class="refsect2">
381 <a name="GSSDPClient-message-received"></a><h3>The <code class="literal">"message-received"</code> signal</h3>
382 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GSSDPClient.html" title="GSSDPClient"><span class="type">GSSDPClient</span></a> *arg0,
383                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>       *arg1,
384                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>        arg2,
385                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>         arg3,
386                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>     arg4,
387                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>     user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
388 <p>
389 Internal signal.
390 </p>
391 <div class="variablelist"><table border="0">
392 <col align="left" valign="top">
393 <tbody><tr>
394 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
395 <td>user data set when the signal handler was connected.</td>
396 </tr></tbody>
397 </table></div>
398 <p class="stability">Stability Level: Private</p>
399 </div>
400 </div>
401 </div>
402 <div class="footer">
403 <hr>
404           Generated by GTK-Doc V1.18</div>
405 </body>
406 </html>