doc/html/GUPnPServiceInfo.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>GUPnPServiceInfo</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="GUPnP Reference Manual">
   8 <link rel="up" href="api-device-info.html" title="Device Information">
   9 <link rel="prev" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo">
  10 <link rel="next" href="gupnp-gupnp-service-introspection.html" title="GUPnPServiceIntrospection">
  11 <meta name="generator" content="GTK-Doc V1.15.1 (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="GUPnPDeviceInfo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="api-device-info.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">GUPnP Reference Manual</th>
  21 <td><a accesskey="n" href="gupnp-gupnp-service-introspection.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="#GUPnPServiceInfo.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GUPnPServiceInfo.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GUPnPServiceInfo.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GUPnPServiceInfo.properties" class="shortcut">Properties</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="GUPnPServiceInfo"></a><div class="titlepage"></div>
  35 <div class="refnamediv"><table width="100%"><tr>
  36 <td valign="top">
  37 <h2><span class="refentrytitle"><a name="GUPnPServiceInfo.top_of_page"></a>GUPnPServiceInfo</span></h2>
  38 <p>GUPnPServiceInfo — Base abstract class for querying service information.</p>
  39 </td>
  40 <td valign="top" align="right"></td>
  41 </tr></table></div>
  42 <div class="refsynopsisdiv">
  43 <a name="GUPnPServiceInfo.synopsis"></a><h2>Synopsis</h2>
  44 <pre class="synopsis">                    <a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo-struct" title="GUPnPServiceInfo">GUPnPServiceInfo</a>;
  45 <span class="returnvalue">void</span>                (<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceIntrospectionCallback" title="GUPnPServiceIntrospectionCallback ()">*GUPnPServiceIntrospectionCallback</a>)
  46                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
  47                                                          <em class="parameter"><code><a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="type">GUPnPServiceIntrospection</span></a> *introspection</code></em>,
  48                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
  49                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  50 <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *      <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-context" title="gupnp_service_info_get_context ()">gupnp_service_info_get_context</a>      (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  51 const <span class="returnvalue">char</span> *        <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-location" title="gupnp_service_info_get_location ()">gupnp_service_info_get_location</a>     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  52 const <span class="returnvalue">SoupURI</span> *     <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-url-base" title="gupnp_service_info_get_url_base ()">gupnp_service_info_get_url_base</a>     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  53 const <span class="returnvalue">char</span> *        <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-udn" title="gupnp_service_info_get_udn ()">gupnp_service_info_get_udn</a>          (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  54 const <span class="returnvalue">char</span> *        <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-service-type" title="gupnp_service_info_get_service_type ()">gupnp_service_info_get_service_type</a> (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  55 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-id" title="gupnp_service_info_get_id ()">gupnp_service_info_get_id</a>           (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  56 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-scpd-url" title="gupnp_service_info_get_scpd_url ()">gupnp_service_info_get_scpd_url</a>     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  57 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-control-url" title="gupnp_service_info_get_control_url ()">gupnp_service_info_get_control_url</a>  (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  58 <span class="returnvalue">char</span> *              <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-event-subscription-url" title="gupnp_service_info_get_event_subscription_url ()">gupnp_service_info_get_event_subscription_url</a>
  59                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);
  60 <a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="returnvalue">GUPnPServiceIntrospection</span></a> * <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-introspection" title="gupnp_service_info_get_introspection ()">gupnp_service_info_get_introspection</a>
  61                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
  62                                                          <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>);
  63 <span class="returnvalue">void</span>                <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-introspection-async" title="gupnp_service_info_get_introspection_async ()">gupnp_service_info_get_introspection_async</a>
  64                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
  65                                                          <em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html#GUPnPServiceIntrospectionCallback" title="GUPnPServiceIntrospectionCallback ()"><span class="type">GUPnPServiceIntrospectionCallback</span></a> callback</code></em>,
  66                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
  67 </pre>
  68 </div>
  69 <div class="refsect1">
  70 <a name="GUPnPServiceInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
  71 <pre class="synopsis">
  72   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  73    +----GUPnPServiceInfo
  74          +----<a class="link" href="GUPnPService.html" title="GUPnPService">GUPnPService</a>
  75          +----<a class="link" href="GUPnPServiceProxy.html" title="GUPnPServiceProxy">GUPnPServiceProxy</a>
  76 </pre>
  77 </div>
  78 <div class="refsect1">
  79 <a name="GUPnPServiceInfo.properties"></a><h2>Properties</h2>
  80 <pre class="synopsis">
  81   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--context" title='The "context" property'>context</a>"                  <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>*         : Read / Write / Construct Only
  82   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--document" title='The "document" property'>document</a>"                 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>*          : Write / Construct Only
  83   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--element" title='The "element" property'>element</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only
  84   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--location" title='The "location" property'>location</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
  85   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--service-type" title='The "service-type" property'>service-type</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
  86   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--udn" title='The "udn" property'>udn</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
  87   "<a class="link" href="GUPnPServiceInfo.html#GUPnPServiceInfo--url-base" title='The "url-base" property'>url-base</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
  88 </pre>
  89 </div>
  90 <div class="refsect1">
  91 <a name="GUPnPServiceInfo.description"></a><h2>Description</h2>
  92 <p>
  93 The <a class="link" href="GUPnPDeviceInfo.html" title="GUPnPDeviceInfo"><span class="type">GUPnPDeviceInfo</span></a> base abstract class provides methods for querying
  94 service information.
  95 </p>
  96 <p>
  97 </p>
  98 </div>
  99 <div class="refsect1">
 100 <a name="GUPnPServiceInfo.details"></a><h2>Details</h2>
 101 <div class="refsect2">
 102 <a name="GUPnPServiceInfo-struct"></a><h3>GUPnPServiceInfo</h3>
 103 <pre class="programlisting">typedef struct _GUPnPServiceInfo GUPnPServiceInfo;</pre>
 104 <p>
 105 This struct contains private data only, and should be accessed using the
 106 functions below.
 107 </p>
 108 <p>
 109 </p>
 110 </div>
 111 <hr>
 112 <div class="refsect2">
 113 <a name="GUPnPServiceIntrospectionCallback"></a><h3>GUPnPServiceIntrospectionCallback ()</h3>
 114 <pre class="programlisting"><span class="returnvalue">void</span>                (*GUPnPServiceIntrospectionCallback)
 115                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
 116                                                          <em class="parameter"><code><a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="type">GUPnPServiceIntrospection</span></a> *introspection</code></em>,
 117                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> *error</code></em>,
 118                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 119 <p>
 120 Callback notifying that <em class="parameter"><code>introspection</code></em> for <em class="parameter"><code>info</code></em> has been obtained.
 121 </p>
 122 <p>
 123 </p>
 124 <div class="variablelist"><table border="0">
 125 <col align="left" valign="top">
 126 <tbody>
 127 <tr>
 128 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 129 <td>The <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> introspection was requested for
 130 </td>
 131 </tr>
 132 <tr>
 133 <td><p><span class="term"><em class="parameter"><code>introspection</code></em> :</span></p></td>
 134 <td>The new <a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="type">GUPnPServiceIntrospection</span></a> object, or NULL
 135 </td>
 136 </tr>
 137 <tr>
 138 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 139 <td>The <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that occurred, or NULL
 140 </td>
 141 </tr>
 142 <tr>
 143 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 144 <td>User data
 145 </td>
 146 </tr>
 147 </tbody>
 148 </table></div>
 149 </div>
 150 <hr>
 151 <div class="refsect2">
 152 <a name="gupnp-service-info-get-context"></a><h3>gupnp_service_info_get_context ()</h3>
 153 <pre class="programlisting"><a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="returnvalue">GUPnPContext</span></a> *      gupnp_service_info_get_context      (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 154 <p>
 155 Get the <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> associated with <em class="parameter"><code>info</code></em>.
 156 </p>
 157 <p>
 158 </p>
 159 <div class="variablelist"><table border="0">
 160 <col align="left" valign="top">
 161 <tbody>
 162 <tr>
 163 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 164 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 165 </td>
 166 </tr>
 167 <tr>
 168 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 169 <td> A <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>.
 170 </td>
 171 </tr>
 172 </tbody>
 173 </table></div>
 174 </div>
 175 <hr>
 176 <div class="refsect2">
 177 <a name="gupnp-service-info-get-location"></a><h3>gupnp_service_info_get_location ()</h3>
 178 <pre class="programlisting">const <span class="returnvalue">char</span> *        gupnp_service_info_get_location     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 179 <p>
 180 Get the location of the device description file.
 181 </p>
 182 <p>
 183 </p>
 184 <div class="variablelist"><table border="0">
 185 <col align="left" valign="top">
 186 <tbody>
 187 <tr>
 188 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 189 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 190 </td>
 191 </tr>
 192 <tr>
 193 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 194 <td> A constant string.
 195 </td>
 196 </tr>
 197 </tbody>
 198 </table></div>
 199 </div>
 200 <hr>
 201 <div class="refsect2">
 202 <a name="gupnp-service-info-get-url-base"></a><h3>gupnp_service_info_get_url_base ()</h3>
 203 <pre class="programlisting">const <span class="returnvalue">SoupURI</span> *     gupnp_service_info_get_url_base     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 204 <p>
 205 Get the URL base of this service.
 206 </p>
 207 <p>
 208 </p>
 209 <div class="variablelist"><table border="0">
 210 <col align="left" valign="top">
 211 <tbody>
 212 <tr>
 213 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 214 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 215 </td>
 216 </tr>
 217 <tr>
 218 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 219 <td> A constant <span class="type">SoupURI</span>.
 220 </td>
 221 </tr>
 222 </tbody>
 223 </table></div>
 224 </div>
 225 <hr>
 226 <div class="refsect2">
 227 <a name="gupnp-service-info-get-udn"></a><h3>gupnp_service_info_get_udn ()</h3>
 228 <pre class="programlisting">const <span class="returnvalue">char</span> *        gupnp_service_info_get_udn          (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 229 <p>
 230 Get the Unique Device Name of the containing device.
 231 </p>
 232 <p>
 233 </p>
 234 <div class="variablelist"><table border="0">
 235 <col align="left" valign="top">
 236 <tbody>
 237 <tr>
 238 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 239 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 240 </td>
 241 </tr>
 242 <tr>
 243 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 244 <td> A constant string.
 245 </td>
 246 </tr>
 247 </tbody>
 248 </table></div>
 249 </div>
 250 <hr>
 251 <div class="refsect2">
 252 <a name="gupnp-service-info-get-service-type"></a><h3>gupnp_service_info_get_service_type ()</h3>
 253 <pre class="programlisting">const <span class="returnvalue">char</span> *        gupnp_service_info_get_service_type (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 254 <p>
 255 Get the UPnP service type, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 256 </p>
 257 <p>
 258 </p>
 259 <div class="variablelist"><table border="0">
 260 <col align="left" valign="top">
 261 <tbody>
 262 <tr>
 263 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 264 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 265 </td>
 266 </tr>
 267 <tr>
 268 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 269 <td> A constant string.
 270 </td>
 271 </tr>
 272 </tbody>
 273 </table></div>
 274 </div>
 275 <hr>
 276 <div class="refsect2">
 277 <a name="gupnp-service-info-get-id"></a><h3>gupnp_service_info_get_id ()</h3>
 278 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_service_info_get_id           (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 279 <p>
 280 Get the ID of this service, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no ID.
 281 </p>
 282 <p>
 283 </p>
 284 <div class="variablelist"><table border="0">
 285 <col align="left" valign="top">
 286 <tbody>
 287 <tr>
 288 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 289 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 290 </td>
 291 </tr>
 292 <tr>
 293 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 294 <td> A string. This string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.
 295 </td>
 296 </tr>
 297 </tbody>
 298 </table></div>
 299 </div>
 300 <hr>
 301 <div class="refsect2">
 302 <a name="gupnp-service-info-get-scpd-url"></a><h3>gupnp_service_info_get_scpd_url ()</h3>
 303 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_service_info_get_scpd_url     (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 304 <p>
 305 Get the SCPD URL for this service, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no SCPD.
 306 </p>
 307 <p>
 308 </p>
 309 <div class="variablelist"><table border="0">
 310 <col align="left" valign="top">
 311 <tbody>
 312 <tr>
 313 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 314 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 315 </td>
 316 </tr>
 317 <tr>
 318 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 319 <td> A string. This string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.
 320 </td>
 321 </tr>
 322 </tbody>
 323 </table></div>
 324 </div>
 325 <hr>
 326 <div class="refsect2">
 327 <a name="gupnp-service-info-get-control-url"></a><h3>gupnp_service_info_get_control_url ()</h3>
 328 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_service_info_get_control_url  (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 329 <p>
 330 Get the control URL for this service, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>..
 331 </p>
 332 <p>
 333 </p>
 334 <div class="variablelist"><table border="0">
 335 <col align="left" valign="top">
 336 <tbody>
 337 <tr>
 338 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 339 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 340 </td>
 341 </tr>
 342 <tr>
 343 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 344 <td> A string. This string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.
 345 </td>
 346 </tr>
 347 </tbody>
 348 </table></div>
 349 </div>
 350 <hr>
 351 <div class="refsect2">
 352 <a name="gupnp-service-info-get-event-subscription-url"></a><h3>gupnp_service_info_get_event_subscription_url ()</h3>
 353 <pre class="programlisting"><span class="returnvalue">char</span> *              gupnp_service_info_get_event_subscription_url
 354                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>);</pre>
 355 <p>
 356 Get the event subscription URL for this service, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 357 </p>
 358 <p>
 359 </p>
 360 <div class="variablelist"><table border="0">
 361 <col align="left" valign="top">
 362 <tbody>
 363 <tr>
 364 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 365 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 366 </td>
 367 </tr>
 368 <tr>
 369 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 370 <td> A string. This string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> after use.
 371 </td>
 372 </tr>
 373 </tbody>
 374 </table></div>
 375 </div>
 376 <hr>
 377 <div class="refsect2">
 378 <a name="gupnp-service-info-get-introspection"></a><h3>gupnp_service_info_get_introspection ()</h3>
 379 <pre class="programlisting"><a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="returnvalue">GUPnPServiceIntrospection</span></a> * gupnp_service_info_get_introspection
 380                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
 381                                                          <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>
 382 <p>
 383 Note that introspection object is created from the information in service
 384 description document (SCPD) provided by the service so it can not be created
 385 if the service does not provide an SCPD.
 386 </p>
 387 <p>
 388 Warning: You  should use <a class="link" href="GUPnPServiceInfo.html#gupnp-service-info-get-introspection-async" title="gupnp_service_info_get_introspection_async ()"><code class="function">gupnp_service_info_get_introspection_async()</code></a>
 389 instead, this function re-enter the GMainloop before returning.
 390 </p>
 391 <p>
 392 </p>
 393 <div class="variablelist"><table border="0">
 394 <col align="left" valign="top">
 395 <tbody>
 396 <tr>
 397 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 398 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 399 </td>
 400 </tr>
 401 <tr>
 402 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 403 <td>return location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 404 </td>
 405 </tr>
 406 <tr>
 407 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 408 <td>  A new <a class="link" href="gupnp-gupnp-service-introspection.html#GUPnPServiceIntrospection"><span class="type">GUPnPServiceIntrospection</span></a> for this
 409 service or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Unref after use. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 410 </td>
 411 </tr>
 412 </tbody>
 413 </table></div>
 414 </div>
 415 <hr>
 416 <div class="refsect2">
 417 <a name="gupnp-service-info-get-introspection-async"></a><h3>gupnp_service_info_get_introspection_async ()</h3>
 418 <pre class="programlisting"><span class="returnvalue">void</span>                gupnp_service_info_get_introspection_async
 419                                                         (<em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a> *info</code></em>,
 420                                                          <em class="parameter"><code><a class="link" href="GUPnPServiceInfo.html#GUPnPServiceIntrospectionCallback" title="GUPnPServiceIntrospectionCallback ()"><span class="type">GUPnPServiceIntrospectionCallback</span></a> callback</code></em>,
 421                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 422 <p>
 423 Note that introspection object is created from the information in service
 424 description document (SCPD) provided by the service so it can not be created
 425 if the service does not provide an SCPD.
 426 </p>
 427 <p>
 428 </p>
 429 <div class="variablelist"><table border="0">
 430 <col align="left" valign="top">
 431 <tbody>
 432 <tr>
 433 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 434 <td>A <a class="link" href="GUPnPServiceInfo.html" title="GUPnPServiceInfo"><span class="type">GUPnPServiceInfo</span></a>
 435 </td>
 436 </tr>
 437 <tr>
 438 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 439 <td>(scope async) : callback to be called when introspection object is ready.
 440 </td>
 441 </tr>
 442 <tr>
 443 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 444 <td>user_data to be passed to the callback.
 445 </td>
 446 </tr>
 447 </tbody>
 448 </table></div>
 449 </div>
 450 </div>
 451 <div class="refsect1">
 452 <a name="GUPnPServiceInfo.property-details"></a><h2>Property Details</h2>
 453 <div class="refsect2">
 454 <a name="GUPnPServiceInfo--context"></a><h3>The <code class="literal">"context"</code> property</h3>
 455 <pre class="programlisting">  "context"                  <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a>*         : Read / Write / Construct Only</pre>
 456 <p>
 457 The <a class="link" href="GUPnPContext.html" title="GUPnPContext"><span class="type">GUPnPContext</span></a> to use.
 458 </p>
 459 <p>
 460 </p>
 461 </div>
 462 <hr>
 463 <div class="refsect2">
 464 <a name="GUPnPServiceInfo--document"></a><h3>The <code class="literal">"document"</code> property</h3>
 465 <pre class="programlisting">  "document"                 <a class="link" href="GUPnPXMLDoc.html" title="GUPnPXMLDoc"><span class="type">GUPnPXMLDoc</span></a>*          : Write / Construct Only</pre>
 466 <p>
 467 Private property.
 468 </p>
 469 <p>
 470 </p>
 471 <p class="stability">Stability Level: Private</p>
 472 </div>
 473 <hr>
 474 <div class="refsect2">
 475 <a name="GUPnPServiceInfo--element"></a><h3>The <code class="literal">"element"</code> property</h3>
 476 <pre class="programlisting">  "element"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Write / Construct Only</pre>
 477 <p>
 478 Private property.
 479 </p>
 480 <p>
 481 </p>
 482 <p class="stability">Stability Level: Private</p>
 483 </div>
 484 <hr>
 485 <div class="refsect2">
 486 <a name="GUPnPServiceInfo--location"></a><h3>The <code class="literal">"location"</code> property</h3>
 487 <pre class="programlisting">  "location"                 <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>
 488 <p>
 489 The location of the device description file.
 490 </p>
 491 <p>
 492 </p>
 493 <p>Default value: NULL</p>
 494 </div>
 495 <hr>
 496 <div class="refsect2">
 497 <a name="GUPnPServiceInfo--service-type"></a><h3>The <code class="literal">"service-type"</code> property</h3>
 498 <pre class="programlisting">  "service-type"             <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>
 499 <p>
 500 The service type.
 501 </p>
 502 <p>
 503 </p>
 504 <p>Default value: NULL</p>
 505 </div>
 506 <hr>
 507 <div class="refsect2">
 508 <a name="GUPnPServiceInfo--udn"></a><h3>The <code class="literal">"udn"</code> property</h3>
 509 <pre class="programlisting">  "udn"                      <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>
 510 <p>
 511 The UDN of the containing device.
 512 </p>
 513 <p>
 514 </p>
 515 <p>Default value: NULL</p>
 516 </div>
 517 <hr>
 518 <div class="refsect2">
 519 <a name="GUPnPServiceInfo--url-base"></a><h3>The <code class="literal">"url-base"</code> property</h3>
 520 <pre class="programlisting">  "url-base"                 <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>
 521 <p>
 522 The URL base (<span class="type">SoupURI</span>).
 523 </p>
 524 <p>
 525 </p>
 526 </div>
 527 </div>
 528 </div>
 529 <div class="footer">
 530 <hr>
 531           Generated by GTK-Doc V1.15.1</div>
 532 </body>
 533 </html>