libupnp/docs/dist/html/upnp/UpnpAcceptSubscriptionExt.html
2006-07-06 12:37:29 +00:00

55 lines
2.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>EXPORT_SPEC int UpnpAcceptSubscriptionExt</TITLE>
<META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
</HEAD>
<BODY BGCOLOR="#ffffff">
<H2>EXPORT_SPEC int <A HREF="#DOC.DOCU">UpnpAcceptSubscriptionExt</A></H2><H2>( IN <!1><A HREF="UpnpDevice_Handle.html">UpnpDevice_Handle</A> Hnd,<BR>&nbsp; IN const char* DevID,<BR>&nbsp; IN const char* ServID,<BR>&nbsp; IN IXML_Document* PropSet,<BR>&nbsp; IN Upnp_SID SubsId )</H2><BLOCKQUOTE><B>UpnpAcceptSubscriptionExt</B> is similar to <B>UpnpAcceptSubscription</B> except that it takes a DOM document for the variables to event rather than an array of strings.</BLOCKQUOTE>
<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE><B>UpnpAcceptSubscriptionExt</B> is similar to <B>UpnpAcceptSubscription</B>
except that it takes a DOM document for the variables to event rather
than an array of strings. This function is sychronous
and generates no callbacks.
<P><B>UpnpAcceptSubscriptionExt</B> can be called during the execution of
a callback function.
<P></BLOCKQUOTE>
<DL><DT><DT><B>Parameters:</B><DD><B>Hnd</B> - The handle of the device.
<BR><B>DevID</B> - The device ID of the subdevice of the
service generating the event.
<BR><B>ServID</B> - The unique service identifier of the service
generating the event.
<BR><B>PropSet</B> - The DOM document for the property set.
Property set documents must conform to
the XML schema defined in section 4.3 of the
Universal Plug and Play Device Architecture
specification.
<BR><B>SubsId</B> - The subscription ID of the newly
registered control point. <BR><DT><B>Returns:</B><DD> [int] An integer representing one of the following:
<UL>
<LI> <TT>UPNP_E_SUCCESS</TT>: The operation completed successfully.
<LI> <TT>UPNP_E_INVALID_HANDLE</TT>: The handle is not a valid device
handle.
<LI> <TT>UPNP_E_INVALID_SERVICE</TT>: The <B>DevId</B>/<B>ServId</B>
pair refers to an invalid service.
<LI> <TT>UPNP_E_INVALID_SID</TT>: The specified subscription ID is not
valid.
<LI> <TT>UPNP_E_INVALID_PARAM</TT>: Either <B>VarName</B>,
<B>NewVal</B>, <B>DevID</B>, <B>ServID</B>, or <B>PropSet</B>
is not a valid pointer.
<LI> <TT>UPNP_E_OUTOF_MEMORY</TT>: Insufficient resources exist to
complete this operation.
</UL>
<BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
<BR>
This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
</BODY>
</HTML>