1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GUPnP Reference Manual: GUPnPContextManager</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7 <link rel="home" href="index.html" title="GUPnP Reference Manual">
8 <link rel="up" href="api-context.html" title="Network context handling">
9 <link rel="prev" href="GUPnPContext.html" title="GUPnPContext">
10 <link rel="next" href="api-utility.html" title="Utility Functions">
11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
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="10"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
18 <a href="#GUPnPContextManager.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
19 <a href="#GUPnPContextManager.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
20 <a href="#GUPnPContextManager.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
21 <a href="#GUPnPContextManager.signals" class="shortcut">Signals</a></span>
23 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24 <td><a accesskey="u" href="api-context.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25 <td><a accesskey="p" href="GUPnPContext.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26 <td><a accesskey="n" href="api-utility.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
28 <div class="refentry">
29 <a name="GUPnPContextManager"></a><div class="titlepage"></div>
30 <div class="refnamediv"><table width="100%"><tr>
32 <h2><span class="refentrytitle"><a name="GUPnPContextManager.top_of_page"></a>GUPnPContextManager</span></h2>
33 <p>GUPnPContextManager — Manages GUPnPContext objects.</p>
35 <td class="gallery_image" valign="top" align="right"></td>
37 <div class="refsect1">
38 <a name="GUPnPContextManager.functions"></a><h2>Functions</h2>
39 <div class="informaltable"><table width="100%" border="0">
41 <col width="150px" class="functions_return">
42 <col class="functions_name">
46 <td class="function_type">
47 <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
49 <td class="function_name">
50 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-new" title="gupnp_context_manager_new ()">gupnp_context_manager_new</a> <span class="c_punctuation">()</span>
54 <td class="function_type">
55 <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
57 <td class="function_name">
58 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-create" title="gupnp_context_manager_create ()">gupnp_context_manager_create</a> <span class="c_punctuation">()</span>
62 <td class="function_type">
63 <span class="returnvalue">void</span>
65 <td class="function_name">
66 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-rescan-control-points" title="gupnp_context_manager_rescan_control_points ()">gupnp_context_manager_rescan_control_points</a> <span class="c_punctuation">()</span>
70 <td class="function_type">
71 <span class="returnvalue">void</span>
73 <td class="function_name">
74 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-manage-control-point" title="gupnp_context_manager_manage_control_point ()">gupnp_context_manager_manage_control_point</a> <span class="c_punctuation">()</span>
78 <td class="function_type">
79 <span class="returnvalue">void</span>
81 <td class="function_name">
82 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-manage-root-device" title="gupnp_context_manager_manage_root_device ()">gupnp_context_manager_manage_root_device</a> <span class="c_punctuation">()</span>
86 <td class="function_type">
87 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
89 <td class="function_name">
90 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-get-port" title="gupnp_context_manager_get_port ()">gupnp_context_manager_get_port</a> <span class="c_punctuation">()</span>
94 <td class="function_type">
95 <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="returnvalue">GUPnPWhiteList</span></a> *
97 <td class="function_name">
98 <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-get-white-list" title="gupnp_context_manager_get_white_list ()">gupnp_context_manager_get_white_list</a> <span class="c_punctuation">()</span>
104 <div class="refsect1">
105 <a name="GUPnPContextManager.properties"></a><h2>Properties</h2>
106 <div class="informaltable"><table border="0">
108 <col width="150px" class="properties_type">
109 <col width="300px" class="properties_name">
110 <col width="200px" class="properties_flags">
114 <td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td>
115 <td class="property_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager--main-context" title="The “main-context” property">main-context</a></td>
116 <td class="property_flags">Read / Write / Construct Only</td>
119 <td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td>
120 <td class="property_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager--port" title="The “port” property">port</a></td>
121 <td class="property_flags">Read / Write / Construct Only</td>
124 <td class="property_type">
125 <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="type">GUPnPWhiteList</span></a> *</td>
126 <td class="property_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager--white-list" title="The “white-list” property">white-list</a></td>
127 <td class="property_flags">Read</td>
132 <div class="refsect1">
133 <a name="GUPnPContextManager.signals"></a><h2>Signals</h2>
134 <div class="informaltable"><table border="0">
136 <col width="150px" class="signals_return">
137 <col width="300px" class="signals_name">
138 <col width="200px" class="signals_flags">
142 <td class="signal_type"><span class="returnvalue">void</span></td>
143 <td class="signal_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager-context-available" title="The “context-available” signal">context-available</a></td>
144 <td class="signal_flags">Run First</td>
147 <td class="signal_type"><span class="returnvalue">void</span></td>
148 <td class="signal_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager-context-unavailable" title="The “context-unavailable” signal">context-unavailable</a></td>
149 <td class="signal_flags">Run First</td>
154 <div class="refsect1">
155 <a name="GUPnPContextManager.other"></a><h2>Types and Values</h2>
156 <div class="informaltable"><table width="100%" border="0">
158 <col width="150px" class="name">
159 <col class="description">
162 <td class="datatype_keyword">struct</td>
163 <td class="function_name"><a class="link" href="GUPnPContextManager.html#GUPnPContextManager-struct" title="struct GUPnPContextManager">GUPnPContextManager</a></td>
167 <div class="refsect1">
168 <a name="GUPnPContextManager.object-hierarchy"></a><h2>Object Hierarchy</h2>
169 <pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
170 <span class="lineart">╰──</span> GUPnPContextManager
173 <div class="refsect1">
174 <a name="GUPnPContextManager.description"></a><h2>Description</h2>
175 <p>A Utility class that takes care of creation and destruction of
176 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> objects for all available network interfaces as they go up
177 (connect) and down (disconnect), respectively.</p>
179 <div class="refsect1">
180 <a name="GUPnPContextManager.functions_details"></a><h2>Functions</h2>
181 <div class="refsect2">
182 <a name="gupnp-context-manager-new"></a><h3>gupnp_context_manager_new ()</h3>
183 <pre class="programlisting"><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
184 gupnp_context_manager_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>,
185 <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);</pre>
186 <div class="warning">
187 <p><code class="literal">gupnp_context_manager_new</code> has been deprecated since version 0.17.2 and should not be used in newly-written code.</p>
188 <p>Use <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-create" title="gupnp_context_manager_create ()"><code class="function">gupnp_context_manager_create()</code></a>.</p>
190 <p>Same as <a class="link" href="GUPnPContextManager.html#gupnp-context-manager-create" title="gupnp_context_manager_create ()"><code class="function">gupnp_context_manager_create()</code></a>.</p>
191 <div class="refsect3">
192 <a name="id-1.3.5.3.9.2.7"></a><h4>Parameters</h4>
193 <div class="informaltable"><table width="100%" border="0">
195 <col width="150px" class="parameters_name">
196 <col class="parameters_description">
197 <col width="200px" class="parameters_annotations">
201 <td class="parameter_name"><p>main_context</p></td>
202 <td class="parameter_description"><p> Deprecated: 0.17.2: <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If you want to use
203 a different main context use
204 <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> instead. </p></td>
205 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
208 <td class="parameter_name"><p>port</p></td>
209 <td class="parameter_description"><p>Port to create contexts for, or 0 if you don't care what port is used.</p></td>
210 <td class="parameter_annotations"> </td>
215 <div class="refsect3">
216 <a name="id-1.3.5.3.9.2.8"></a><h4>Returns</h4>
217 <p> A new <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> object. </p>
218 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
220 <p class="since">Since 0.13.0</p>
223 <div class="refsect2">
224 <a name="gupnp-context-manager-create"></a><h3>gupnp_context_manager_create ()</h3>
225 <pre class="programlisting"><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
226 gupnp_context_manager_create (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> port</code></em>);</pre>
227 <p>Factory-method to create a new <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a>. The final type of the
228 <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> depends on the compile-time selection or - in case of
229 NetworkManager - on its availability during runtime. If it is not available,
230 the implementation falls back to the basic Unix context manager instead.</p>
231 <div class="refsect3">
232 <a name="id-1.3.5.3.9.3.5"></a><h4>Parameters</h4>
233 <div class="informaltable"><table width="100%" border="0">
235 <col width="150px" class="parameters_name">
236 <col class="parameters_description">
237 <col width="200px" class="parameters_annotations">
240 <td class="parameter_name"><p>port</p></td>
241 <td class="parameter_description"><p>Port to create contexts for, or 0 if you don't care what port is used.</p></td>
242 <td class="parameter_annotations"> </td>
246 <div class="refsect3">
247 <a name="id-1.3.5.3.9.3.6"></a><h4>Returns</h4>
248 <p> A new <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> object. </p>
249 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
251 <p class="since">Since 0.17.2</p>
254 <div class="refsect2">
255 <a name="gupnp-context-manager-rescan-control-points"></a><h3>gupnp_context_manager_rescan_control_points ()</h3>
256 <pre class="programlisting"><span class="returnvalue">void</span>
257 gupnp_context_manager_rescan_control_points
258 (<em class="parameter"><code><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *manager</code></em>);</pre>
259 <p>This function starts a rescan on every control point managed by <em class="parameter"><code>manager</code></em>
261 Only the active control points send discovery messages.
262 This function should be called when servers are suspected to have
264 <div class="refsect3">
265 <a name="id-1.3.5.3.9.4.5"></a><h4>Parameters</h4>
266 <div class="informaltable"><table width="100%" border="0">
268 <col width="150px" class="parameters_name">
269 <col class="parameters_description">
270 <col width="200px" class="parameters_annotations">
273 <td class="parameter_name"><p>manager</p></td>
274 <td class="parameter_description"><p>A <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a></p></td>
275 <td class="parameter_annotations"> </td>
279 <p class="since">Since 0.20.3</p>
282 <div class="refsect2">
283 <a name="gupnp-context-manager-manage-control-point"></a><h3>gupnp_context_manager_manage_control_point ()</h3>
284 <pre class="programlisting"><span class="returnvalue">void</span>
285 gupnp_context_manager_manage_control_point
286 (<em class="parameter"><code><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *manager</code></em>,
287 <em class="parameter"><code><a class="link" href="GUPnPControlPoint.html" title="GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a> *control_point</code></em>);</pre>
288 <p>By calling this function, you are asking <em class="parameter"><code>manager</code></em>
289 to keep a reference to
290 <em class="parameter"><code>control_point</code></em>
291 until it's associated <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> is no longer available.
292 You usually want to call this function from
293 <a class="link" href="GUPnPContextManager.html#GUPnPContextManager-context-available" title="The “context-available” signal"><span class="type">“context-available”</span></a> handler after you create a
294 <a class="link" href="GUPnPControlPoint.html" title="GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a> object for the newly available context.</p>
295 <div class="refsect3">
296 <a name="id-1.3.5.3.9.5.5"></a><h4>Parameters</h4>
297 <div class="informaltable"><table width="100%" border="0">
299 <col width="150px" class="parameters_name">
300 <col class="parameters_description">
301 <col width="200px" class="parameters_annotations">
305 <td class="parameter_name"><p>manager</p></td>
306 <td class="parameter_description"><p>A <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a></p></td>
307 <td class="parameter_annotations"> </td>
310 <td class="parameter_name"><p>control_point</p></td>
311 <td class="parameter_description"><p>The <a class="link" href="GUPnPControlPoint.html" title="GUPnPControlPoint"><span class="type">GUPnPControlPoint</span></a> to be taken care of</p></td>
312 <td class="parameter_annotations"> </td>
317 <p class="since">Since 0.13.0</p>
320 <div class="refsect2">
321 <a name="gupnp-context-manager-manage-root-device"></a><h3>gupnp_context_manager_manage_root_device ()</h3>
322 <pre class="programlisting"><span class="returnvalue">void</span>
323 gupnp_context_manager_manage_root_device
324 (<em class="parameter"><code><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *manager</code></em>,
325 <em class="parameter"><code><a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> *root_device</code></em>);</pre>
326 <p>By calling this function, you are asking <em class="parameter"><code>manager</code></em>
327 to keep a reference to
328 <em class="parameter"><code>root_device</code></em>
329 when it's associated <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> is no longer available. You
330 usually want to call this function from
331 <a class="link" href="GUPnPContextManager.html#GUPnPContextManager-context-available" title="The “context-available” signal"><span class="type">“context-available”</span></a> handler after you create a
332 <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> object for the newly available context.</p>
333 <div class="refsect3">
334 <a name="id-1.3.5.3.9.6.5"></a><h4>Parameters</h4>
335 <div class="informaltable"><table width="100%" border="0">
337 <col width="150px" class="parameters_name">
338 <col class="parameters_description">
339 <col width="200px" class="parameters_annotations">
343 <td class="parameter_name"><p>manager</p></td>
344 <td class="parameter_description"><p>A <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a></p></td>
345 <td class="parameter_annotations"> </td>
348 <td class="parameter_name"><p>root_device</p></td>
349 <td class="parameter_description"><p>The <a class="link" href="GUPnPRootDevice.html" title="GUPnPRootDevice"><span class="type">GUPnPRootDevice</span></a> to be taken care of</p></td>
350 <td class="parameter_annotations"> </td>
355 <p class="since">Since 0.13.0</p>
358 <div class="refsect2">
359 <a name="gupnp-context-manager-get-port"></a><h3>gupnp_context_manager_get_port ()</h3>
360 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
361 gupnp_context_manager_get_port (<em class="parameter"><code><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *manager</code></em>);</pre>
362 <p>Get the network port associated with this context manager.</p>
363 <div class="refsect3">
364 <a name="id-1.3.5.3.9.7.5"></a><h4>Parameters</h4>
365 <div class="informaltable"><table width="100%" border="0">
367 <col width="150px" class="parameters_name">
368 <col class="parameters_description">
369 <col width="200px" class="parameters_annotations">
372 <td class="parameter_name"><p>manager</p></td>
373 <td class="parameter_description"><p>A <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a></p></td>
374 <td class="parameter_annotations"> </td>
378 <div class="refsect3">
379 <a name="id-1.3.5.3.9.7.6"></a><h4>Returns</h4>
380 <p> The network port asssociated with this context manager.</p>
383 <p class="since">Since 0.19.1</p>
386 <div class="refsect2">
387 <a name="gupnp-context-manager-get-white-list"></a><h3>gupnp_context_manager_get_white_list ()</h3>
388 <pre class="programlisting"><a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="returnvalue">GUPnPWhiteList</span></a> *
389 gupnp_context_manager_get_white_list (<em class="parameter"><code><a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *manager</code></em>);</pre>
390 <p>Get the <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="type">GUPnPWhiteList</span></a> associated with <em class="parameter"><code>manager</code></em>
392 <div class="refsect3">
393 <a name="id-1.3.5.3.9.8.5"></a><h4>Parameters</h4>
394 <div class="informaltable"><table width="100%" border="0">
396 <col width="150px" class="parameters_name">
397 <col class="parameters_description">
398 <col width="200px" class="parameters_annotations">
401 <td class="parameter_name"><p>manager</p></td>
402 <td class="parameter_description"><p>A <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a></p></td>
403 <td class="parameter_annotations"> </td>
407 <div class="refsect3">
408 <a name="id-1.3.5.3.9.8.6"></a><h4>Returns</h4>
409 <p> The <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="type">GUPnPWhiteList</span></a> asssociated with this
410 context manager. </p>
411 <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
415 <div class="refsect1">
416 <a name="GUPnPContextManager.other_details"></a><h2>Types and Values</h2>
417 <div class="refsect2">
418 <a name="GUPnPContextManager-struct"></a><h3>struct GUPnPContextManager</h3>
419 <pre class="programlisting">struct GUPnPContextManager;</pre>
420 <p>This struct contains private data only, and should be accessed using the
424 <div class="refsect1">
425 <a name="GUPnPContextManager.property-details"></a><h2>Property Details</h2>
426 <div class="refsect2">
427 <a name="GUPnPContextManager--main-context"></a><h3>The <code class="literal">“main-context”</code> property</h3>
428 <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></pre>
429 <p>GMainContext to pass to created GUPnPContext objects.</p>
430 <p>Flags: Read / Write / Construct Only</p>
433 <div class="refsect2">
434 <a name="GUPnPContextManager--port"></a><h3>The <code class="literal">“port”</code> property</h3>
435 <pre class="programlisting"> “port” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
436 <p>Port the contexts listen on, or 0 if you don't care what
437 port is used by <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> objects created by this object.</p>
438 <p>Flags: Read / Write / Construct Only</p>
439 <p>Default value: 0</p>
442 <div class="refsect2">
443 <a name="GUPnPContextManager--white-list"></a><h3>The <code class="literal">“white-list”</code> property</h3>
444 <pre class="programlisting"> “white-list” <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="type">GUPnPWhiteList</span></a> *</pre>
445 <p>The white list to use.</p>
449 <div class="refsect1">
450 <a name="GUPnPContextManager.signal-details"></a><h2>Signal Details</h2>
451 <div class="refsect2">
452 <a name="GUPnPContextManager-context-available"></a><h3>The <code class="literal">“context-available”</code> signal</h3>
453 <pre class="programlisting"><span class="returnvalue">void</span>
454 user_function (<a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *context_manager,
455 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context,
456 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
457 <p>Signals the availability of new <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.</p>
458 <div class="refsect3">
459 <a name="id-1.3.5.3.12.2.5"></a><h4>Parameters</h4>
460 <div class="informaltable"><table width="100%" border="0">
462 <col width="150px" class="parameters_name">
463 <col class="parameters_description">
464 <col width="200px" class="parameters_annotations">
468 <td class="parameter_name"><p>context_manager</p></td>
469 <td class="parameter_description"><p>The <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> that received the signal</p></td>
470 <td class="parameter_annotations"> </td>
473 <td class="parameter_name"><p>context</p></td>
474 <td class="parameter_description"><p>The now available <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a></p></td>
475 <td class="parameter_annotations"> </td>
478 <td class="parameter_name"><p>user_data</p></td>
479 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
480 <td class="parameter_annotations"> </td>
485 <p>Flags: Run First</p>
488 <div class="refsect2">
489 <a name="GUPnPContextManager-context-unavailable"></a><h3>The <code class="literal">“context-unavailable”</code> signal</h3>
490 <pre class="programlisting"><span class="returnvalue">void</span>
491 user_function (<a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> *context_manager,
492 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> *context,
493 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
494 <p>Signals the unavailability of a <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.</p>
495 <div class="refsect3">
496 <a name="id-1.3.5.3.12.3.5"></a><h4>Parameters</h4>
497 <div class="informaltable"><table width="100%" border="0">
499 <col width="150px" class="parameters_name">
500 <col class="parameters_description">
501 <col width="200px" class="parameters_annotations">
505 <td class="parameter_name"><p>context_manager</p></td>
506 <td class="parameter_description"><p>The <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="type">GUPnPContextManager</span></a> that received the signal</p></td>
507 <td class="parameter_annotations"> </td>
510 <td class="parameter_name"><p>context</p></td>
511 <td class="parameter_description"><p>The now unavailable <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a></p></td>
512 <td class="parameter_annotations"> </td>
515 <td class="parameter_name"><p>user_data</p></td>
516 <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
517 <td class="parameter_annotations"> </td>
522 <p>Flags: Run First</p>
528 Generated by GTK-Doc V1.20</div>