doc/html/GUPnPContextManager.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>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">
  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="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>
  22 </td>
  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>
  27 </tr></table>
  28 <div class="refentry">
  29 <a name="GUPnPContextManager"></a><div class="titlepage"></div>
  30 <div class="refnamediv"><table width="100%"><tr>
  31 <td valign="top">
  32 <h2><span class="refentrytitle"><a name="GUPnPContextManager.top_of_page"></a>GUPnPContextManager</span></h2>
  33 <p>GUPnPContextManager — Manages GUPnPContext objects.</p>
  34 </td>
  35 <td class="gallery_image" valign="top" align="right"></td>
  36 </tr></table></div>
  37 <div class="refsect1">
  38 <a name="GUPnPContextManager.functions"></a><h2>Functions</h2>
  39 <div class="informaltable"><table width="100%" border="0">
  40 <colgroup>
  41 <col width="150px" class="functions_return">
  42 <col class="functions_name">
  43 </colgroup>
  44 <tbody>
  45 <tr>
  46 <td class="function_type">
  47 <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
  48 </td>
  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>
  51 </td>
  52 </tr>
  53 <tr>
  54 <td class="function_type">
  55 <a class="link" href="GUPnPContextManager.html" title="GUPnPContextManager"><span class="returnvalue">GUPnPContextManager</span></a> *
  56 </td>
  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>
  59 </td>
  60 </tr>
  61 <tr>
  62 <td class="function_type">
  63 <span class="returnvalue">void</span>
  64 </td>
  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>
  67 </td>
  68 </tr>
  69 <tr>
  70 <td class="function_type">
  71 <span class="returnvalue">void</span>
  72 </td>
  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>
  75 </td>
  76 </tr>
  77 <tr>
  78 <td class="function_type">
  79 <span class="returnvalue">void</span>
  80 </td>
  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>
  83 </td>
  84 </tr>
  85 <tr>
  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>
  88 </td>
  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>
  91 </td>
  92 </tr>
  93 <tr>
  94 <td class="function_type">
  95 <a class="link" href="GUPnPWhiteList.html" title="GUPnPWhiteList"><span class="returnvalue">GUPnPWhiteList</span></a> *
  96 </td>
  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>
  99 </td>
 100 </tr>
 101 </tbody>
 102 </table></div>
 103 </div>
 104 <div class="refsect1">
 105 <a name="GUPnPContextManager.properties"></a><h2>Properties</h2>
 106 <div class="informaltable"><table border="0">
 107 <colgroup>
 108 <col width="150px" class="properties_type">
 109 <col width="300px" class="properties_name">
 110 <col width="200px" class="properties_flags">
 111 </colgroup>
 112 <tbody>
 113 <tr>
 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>
 117 </tr>
 118 <tr>
 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>
 122 </tr>
 123 <tr>
 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>
 128 </tr>
 129 </tbody>
 130 </table></div>
 131 </div>
 132 <div class="refsect1">
 133 <a name="GUPnPContextManager.signals"></a><h2>Signals</h2>
 134 <div class="informaltable"><table border="0">
 135 <colgroup>
 136 <col width="150px" class="signals_return">
 137 <col width="300px" class="signals_name">
 138 <col width="200px" class="signals_flags">
 139 </colgroup>
 140 <tbody>
 141 <tr>
 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>
 145 </tr>
 146 <tr>
 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>
 150 </tr>
 151 </tbody>
 152 </table></div>
 153 </div>
 154 <div class="refsect1">
 155 <a name="GUPnPContextManager.other"></a><h2>Types and Values</h2>
 156 <div class="informaltable"><table width="100%" border="0">
 157 <colgroup>
 158 <col width="150px" class="name">
 159 <col class="description">
 160 </colgroup>
 161 <tbody><tr>
 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>
 164 </tr></tbody>
 165 </table></div>
 166 </div>
 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
 171 </pre>
 172 </div>
 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>
 178 </div>
 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>
 189 </div>
 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">
 194 <colgroup>
 195 <col width="150px" class="parameters_name">
 196 <col class="parameters_description">
 197 <col width="200px" class="parameters_annotations">
 198 </colgroup>
 199 <tbody>
 200 <tr>
 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>
 206 </tr>
 207 <tr>
 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>
 211 </tr>
 212 </tbody>
 213 </table></div>
 214 </div>
 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>
 219 </div>
 220 <p class="since">Since 0.13.0</p>
 221 </div>
 222 <hr>
 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">
 234 <colgroup>
 235 <col width="150px" class="parameters_name">
 236 <col class="parameters_description">
 237 <col width="200px" class="parameters_annotations">
 238 </colgroup>
 239 <tbody><tr>
 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>
 243 </tr></tbody>
 244 </table></div>
 245 </div>
 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>
 250 </div>
 251 <p class="since">Since 0.17.2</p>
 252 </div>
 253 <hr>
 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>
 260 .
 261 Only the active control points send discovery messages.
 262 This function should be called when servers are suspected to have
 263 disappeared.</p>
 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">
 267 <colgroup>
 268 <col width="150px" class="parameters_name">
 269 <col class="parameters_description">
 270 <col width="200px" class="parameters_annotations">
 271 </colgroup>
 272 <tbody><tr>
 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>
 276 </tr></tbody>
 277 </table></div>
 278 </div>
 279 <p class="since">Since 0.20.3</p>
 280 </div>
 281 <hr>
 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">
 298 <colgroup>
 299 <col width="150px" class="parameters_name">
 300 <col class="parameters_description">
 301 <col width="200px" class="parameters_annotations">
 302 </colgroup>
 303 <tbody>
 304 <tr>
 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>
 308 </tr>
 309 <tr>
 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>
 313 </tr>
 314 </tbody>
 315 </table></div>
 316 </div>
 317 <p class="since">Since 0.13.0</p>
 318 </div>
 319 <hr>
 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">
 336 <colgroup>
 337 <col width="150px" class="parameters_name">
 338 <col class="parameters_description">
 339 <col width="200px" class="parameters_annotations">
 340 </colgroup>
 341 <tbody>
 342 <tr>
 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>
 346 </tr>
 347 <tr>
 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>
 351 </tr>
 352 </tbody>
 353 </table></div>
 354 </div>
 355 <p class="since">Since 0.13.0</p>
 356 </div>
 357 <hr>
 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">
 366 <colgroup>
 367 <col width="150px" class="parameters_name">
 368 <col class="parameters_description">
 369 <col width="200px" class="parameters_annotations">
 370 </colgroup>
 371 <tbody><tr>
 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>
 375 </tr></tbody>
 376 </table></div>
 377 </div>
 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>
 381 <p></p>
 382 </div>
 383 <p class="since">Since 0.19.1</p>
 384 </div>
 385 <hr>
 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>
 391 .</p>
 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">
 395 <colgroup>
 396 <col width="150px" class="parameters_name">
 397 <col class="parameters_description">
 398 <col width="200px" class="parameters_annotations">
 399 </colgroup>
 400 <tbody><tr>
 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>
 404 </tr></tbody>
 405 </table></div>
 406 </div>
 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>
 412 </div>
 413 </div>
 414 </div>
 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
 421 functions below.</p>
 422 </div>
 423 </div>
 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>
 431 </div>
 432 <hr>
 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>
 440 </div>
 441 <hr>
 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>
 446 <p>Flags: Read</p>
 447 </div>
 448 </div>
 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">
 461 <colgroup>
 462 <col width="150px" class="parameters_name">
 463 <col class="parameters_description">
 464 <col width="200px" class="parameters_annotations">
 465 </colgroup>
 466 <tbody>
 467 <tr>
 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>
 471 </tr>
 472 <tr>
 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>
 476 </tr>
 477 <tr>
 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>
 481 </tr>
 482 </tbody>
 483 </table></div>
 484 </div>
 485 <p>Flags: Run First</p>
 486 </div>
 487 <hr>
 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">
 498 <colgroup>
 499 <col width="150px" class="parameters_name">
 500 <col class="parameters_description">
 501 <col width="200px" class="parameters_annotations">
 502 </colgroup>
 503 <tbody>
 504 <tr>
 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>
 508 </tr>
 509 <tr>
 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>
 513 </tr>
 514 <tr>
 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>
 518 </tr>
 519 </tbody>
 520 </table></div>
 521 </div>
 522 <p>Flags: Run First</p>
 523 </div>
 524 </div>
 525 </div>
 526 <div class="footer">
 527 <hr>
 528           Generated by GTK-Doc V1.20</div>
 529 </body>
 530 </html>