gupnp-service-proxy.xml

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

value, terminated with <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle. This will
be freed when calling <link linkend="gupnp-service-proxy-cancel-action"><function>gupnp_service_proxy_cancel_action()</function></link> or
<link linkend="gupnp-service-proxy-end-action-valist"><function>gupnp_service_proxy_end_action_valist()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-proxy-begin-action-valist" role="function">
<title>gupnp_service_proxy_begin_action_valist ()</title>
<indexterm zone="gupnp-service-proxy-begin-action-valist"><primary>gupnp_service_proxy_begin_action_valist</primary></indexterm><programlisting><link linkend="GUPnPServiceProxyAction">GUPnPServiceProxyAction</link>* gupnp_service_proxy_begin_action_valist
                                                        (<link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
                                                         const <link linkend="char">char</link> *action,
                                                         <link linkend="GUPnPServiceProxyActionCallback">GUPnPServiceProxyActionCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="va-list">va_list</link> var_args);</programlisting>
<para>
See <link linkend="gupnp-service-proxy-begin-action"><function>gupnp_service_proxy_begin_action()</function></link>; this version takes a va_list for
use by language bindings.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> An action
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> The callback to call when sending the action has succeeded
or failed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara> User data for <parameter>callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>var_args</parameter>&nbsp;:</term>
<listitem><simpara> A va_list of tuples of in parameter name, in paramater type, and
in parameter value
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle. This will
be freed when calling <link linkend="gupnp-service-proxy-cancel-action"><function>gupnp_service_proxy_cancel_action()</function></link> or
<link linkend="gupnp-service-proxy-end-action-valist"><function>gupnp_service_proxy_end_action_valist()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-proxy-begin-action-hash" role="function">
<title>gupnp_service_proxy_begin_action_hash ()</title>
<indexterm zone="gupnp-service-proxy-begin-action-hash"><primary>gupnp_service_proxy_begin_action_hash</primary></indexterm><programlisting><link linkend="GUPnPServiceProxyAction">GUPnPServiceProxyAction</link>* gupnp_service_proxy_begin_action_hash
                                                        (<link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
                                                         const <link linkend="char">char</link> *action,
                                                         <link linkend="GUPnPServiceProxyActionCallback">GUPnPServiceProxyActionCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data,
                                                         <link linkend="GHashTable">GHashTable</link> *hash);</programlisting>
<para>
See <link linkend="gupnp-service-proxy-begin-action"><function>gupnp_service_proxy_begin_action()</function></link>; this version takes a <link linkend="GHashTable"><type>GHashTable</type></link>
for runtime generated parameter lists.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> An action
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> The callback to call when sending the action has succeeded
or failed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara> User data for <parameter>callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>hash</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GHashTable"><type>GHashTable</type></link> of in parameter name and <link linkend="GValue"><type>GValue</type></link> pairs
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle. This will
be freed when calling <link linkend="gupnp-service-proxy-cancel-action"><function>gupnp_service_proxy_cancel_action()</function></link> or
<link linkend="gupnp-service-proxy-end-action-hash"><function>gupnp_service_proxy_end_action_hash()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-proxy-end-action" role="function">
<title>gupnp_service_proxy_end_action ()</title>
<indexterm zone="gupnp-service-proxy-end-action"><primary>gupnp_service_proxy_end_action</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gupnp_service_proxy_end_action      (<link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
                                                         <link linkend="GUPnPServiceProxyAction">GUPnPServiceProxyAction</link> *action,
                                                         <link linkend="GError">GError</link> **error,
                                                         ...);</programlisting>
<para>
Retrieves the result of <parameter>action</parameter>. The out parameters in <parameter>Varargs</parameter> will be
filled in, and if an error occurred, <parameter>error</parameter> will be set. In case of
a UPnPError the error code will be the same in <parameter>error</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> The location where to store any error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
<listitem><simpara> tuples of out parameter name, out paramater type, and out parameter
value location, terminated with <link linkend="NULL:CAPS"><literal>NULL</literal></link>. The out parameter values should be
freed after use
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-proxy-end-action-valist" role="function">
<title>gupnp_service_proxy_end_action_valist ()</title>
<indexterm zone="gupnp-service-proxy-end-action-valist"><primary>gupnp_service_proxy_end_action_valist</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gupnp_service_proxy_end_action_valist
                                                        (<link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
                                                         <link linkend="GUPnPServiceProxyAction">GUPnPServiceProxyAction</link> *action,
                                                         <link linkend="GError">GError</link> **error,
                                                         <link linkend="va-list">va_list</link> var_args);</programlisting>
<para>
See <link linkend="gupnp-service-proxy-end-action"><function>gupnp_service_proxy_end_action()</function></link>; this version takes a va_list for
use by language bindings.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> The location where to store any error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>var_args</parameter>&nbsp;:</term>
<listitem><simpara> A va_list of tuples of out parameter name, out paramater type,
and out parameter value location. The out parameter values should be
freed after use
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> on success.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gupnp-service-proxy-end-action-hash" role="function">
<title>gupnp_service_proxy_end_action_hash ()</title>
<indexterm zone="gupnp-service-proxy-end-action-hash"><primary>gupnp_service_proxy_end_action_hash</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gupnp_service_proxy_end_action_hash (<link linkend="GUPnPServiceProxy">GUPnPServiceProxy</link> *proxy,
                                                         <link linkend="GUPnPServiceProxyAction">GUPnPServiceProxyAction</link> *action,
                                                         <link linkend="GError">GError</link> **error,
                                                         <link linkend="GHashTable">GHashTable</link> *hash);</programlisting>
<para>
See <link linkend="gupnp-service-proxy-end-action"><function>gupnp_service_proxy_end_action()</function></link>; this version takes a <link linkend="GHashTable"><type>GHashTable</type></link>
for runtime generated parameter lists.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>proxy</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxy"><type>GUPnPServiceProxy</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action</parameter>&nbsp;:</term>
<listitem><simpara> A <link linkend="GUPnPServiceProxyAction"><type>GUPnPServiceProxyAction</type></link> handle
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&nbsp;:</term>
<listitem><simpara> The location where to store any error, or <link linkend="NULL:CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>hash</parameter>&nbsp;:</term>