gupnp-service-info.xml

另一 UPNP SDK 支持在UNIX/LINUX上运行。 UPnP是一种网络协议

<para>
Get the UPnP service type, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A constant string.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-id" role="function">
<title>gupnp_service_info_get_id ()</title>
<indexterm zone="gupnp-service-info-get-id"><primary>gupnp_service_info_get_id</primary></indexterm><programlisting><link linkend="char">char</link>*               gupnp_service_info_get_id           (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info);</programlisting>
<para>
Get the ID of this service, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if there is no ID.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A string. This string should be freed with <link linkend="g-free"><function>g_free()</function></link> after use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-scpd-url" role="function">
<title>gupnp_service_info_get_scpd_url ()</title>
<indexterm zone="gupnp-service-info-get-scpd-url"><primary>gupnp_service_info_get_scpd_url</primary></indexterm><programlisting><link linkend="char">char</link>*               gupnp_service_info_get_scpd_url     (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info);</programlisting>
<para>
Get the SCPD URL for this service, or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if there is no SCPD.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A string. This string should be freed with <link linkend="g-free"><function>g_free()</function></link> after use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-control-url" role="function">
<title>gupnp_service_info_get_control_url ()</title>
<indexterm zone="gupnp-service-info-get-control-url"><primary>gupnp_service_info_get_control_url</primary></indexterm><programlisting><link linkend="char">char</link>*               gupnp_service_info_get_control_url  (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info);</programlisting>
<para>
Get the control URL for this service, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>..</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A string. This string should be freed with <link linkend="g-free"><function>g_free()</function></link> after use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-event-subscription-url" role="function">
<title>gupnp_service_info_get_event_subscription_url ()</title>
<indexterm zone="gupnp-service-info-get-event-subscription-url"><primary>gupnp_service_info_get_event_subscription_url</primary></indexterm><programlisting><link linkend="char">char</link>*               gupnp_service_info_get_event_subscription_url
                                                        (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info);</programlisting>
<para>
Get the event subscription URL for this service, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A string. This string should be freed with <link linkend="g-free"><function>g_free()</function></link> after use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-introspection" role="function">
<title>gupnp_service_info_get_introspection ()</title>
<indexterm zone="gupnp-service-info-get-introspection"><primary>gupnp_service_info_get_introspection</primary></indexterm><programlisting><link linkend="GUPnPServiceIntrospection">GUPnPServiceIntrospection</link>* gupnp_service_info_get_introspection
                                                        (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Note that introspection object is created from the information in service
description document (SCPD) provided by the service so it can not be created
if the service does not provide an SCPD.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> return location for a <link linkend="GError"><type>GError</type></link>, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A new <link linkend="GUPnPServiceIntrospection"><type>GUPnPServiceIntrospection</type></link> for this service or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
Unref after use.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-info-get-introspection-async" role="function">
<title>gupnp_service_info_get_introspection_async ()</title>
<indexterm zone="gupnp-service-info-get-introspection-async"><primary>gupnp_service_info_get_introspection_async</primary></indexterm><programlisting><link linkend="void">void</link>                gupnp_service_info_get_introspection_async
                                                        (<link linkend="GUPnPServiceInfo">GUPnPServiceInfo</link> *info,
                                                         <link linkend="GUPnPServiceIntrospectionCallback">GUPnPServiceIntrospectionCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Note that introspection object is created from the information in service
description document (SCPD) provided by the service so it can not be created
if the service does not provide an SCPD.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>info</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceInfo"><type>GUPnPServiceInfo</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> callback to be called when introspection object is ready.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara> user_data to be passed to the callback.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="GUPnPServiceInfo.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GUPnPServiceInfo--context"><title>The <literal>&quot;context&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--context"><primary>GUPnPServiceInfo:context</primary></indexterm><programlisting>  &quot;context&quot;                  <link linkend="GUPnPContext">GUPnPContext</link>*         : Read / Write / Construct Only</programlisting>
<para>
The <link linkend="GUPnPContext"><type>GUPnPContext</type></link> to use.</para>
<para>

</para></refsect2>
<refsect2 id="GUPnPServiceInfo--document"><title>The <literal>&quot;document&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--document"><primary>GUPnPServiceInfo:document</primary></indexterm><programlisting>  &quot;document&quot;                 <link linkend="XmlDocWrapper">XmlDocWrapper</link>*        : Write / Construct Only</programlisting>
<para>
Private property.</para>
<para>

</para><para>Stability Level Private</para>
</refsect2>
<refsect2 id="GUPnPServiceInfo--element"><title>The <literal>&quot;element&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--element"><primary>GUPnPServiceInfo:element</primary></indexterm><programlisting>  &quot;element&quot;                  <link linkend="gpointer">gpointer</link>              : Write / Construct Only</programlisting>
<para>
Private property.</para>
<para>

</para><para>Stability Level Private</para>
</refsect2>
<refsect2 id="GUPnPServiceInfo--location"><title>The <literal>&quot;location&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--location"><primary>GUPnPServiceInfo:location</primary></indexterm><programlisting>  &quot;location&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write / Construct Only</programlisting>
<para>
The location of the device description file.</para>
<para>

</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="GUPnPServiceInfo--service-type"><title>The <literal>&quot;service-type&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--service-type"><primary>GUPnPServiceInfo:service-type</primary></indexterm><programlisting>  &quot;service-type&quot;             <link linkend="gchar">gchar</link>*                : Read / Write / Construct Only</programlisting>
<para>
The service type.</para>
<para>

</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="GUPnPServiceInfo--udn"><title>The <literal>&quot;udn&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--udn"><primary>GUPnPServiceInfo:udn</primary></indexterm><programlisting>  &quot;udn&quot;                      <link linkend="gchar">gchar</link>*                : Read / Write / Construct Only</programlisting>
<para>
The UDN of the containing device.</para>
<para>

</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="GUPnPServiceInfo--url-base"><title>The <literal>&quot;url-base&quot;</literal> property</title>
<indexterm zone="GUPnPServiceInfo--url-base"><primary>GUPnPServiceInfo:url-base</primary></indexterm><programlisting>  &quot;url-base&quot;                 <link linkend="gpointer">gpointer</link>              : Read / Write / Construct Only</programlisting>
<para>
The URL base (<link linkend="SoupURI"><type>SoupURI</type></link>).</para>
<para>

</para></refsect2>

</refsect1>




</refentry>