Sophie: libupnp-devel-1.6.6-2mdv2010.0 i586

libupnp-devel-1.6.6-2mdv2010.0.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>
<HEAD>
   <TITLE>EXPORT_SPEC int UpnpGetServiceVarStatus</TITLE>
   <META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
</HEAD>
<BODY BGCOLOR="#ffffff">

<H2>EXPORT_SPEC int <A HREF="#DOC.DOCU">UpnpGetServiceVarStatus</A></H2><H2>( IN <!1><A HREF="UpnpClient_Handle.html">UpnpClient_Handle</A> Hnd,<BR>&nbsp;  IN const char* ActionURL,<BR>&nbsp;  IN const char* VarName,<BR>&nbsp;  OUT DOMString* StVarVal )</H2><BLOCKQUOTE><B>UpnpGetServiceVarStatus</B> queries the state of a state  variable of a service on another device.</BLOCKQUOTE>

<A NAME="DOC.DOCU"></A>
<HR>
<H2>Documentation</H2>
<BLOCKQUOTE><B>UpnpGetServiceVarStatus</B> queries the state of a state 
variable of a service on another device.  This is a synchronous call.
A positive return value indicates a SOAP error code, whereas a negative
return code indicates an SDK error code. <B>Note that the use of this 
function is deprecated by the UPnP Forum</B>.

<P></BLOCKQUOTE>
<DL><DT><DT><B>Parameters:</B><DD><B>Hnd</B> -   The handle of the control point. 
<BR><B>ActionURL</B> -   The URL of the service. 
<BR><B>VarName</B> -   The name of the variable to query. 
<BR><B>StVarVal</B> -   The pointer to store the value 
for <B>VarName</B>. The SDK 
allocates this string and the caller 
needs to free it using 
<B>ixmlFreeDOMString</B>. <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 control 
point handle.
<LI> <TT>UPNP_E_INVALID_URL</TT>: <B>ActionUrl</B> is not a valid URL.
<LI> <TT>UPNP_E_INVALID_DESC</TT>: The XML document was not 
found or it does not contain a valid XML description.
<LI> <TT>UPNP_E_INVALID_PARAM</TT>: <B>StVarVal</B> is not a valid 
pointer or <B>VarName</B> or <B>ActionUrl</B> is <TT>NULL</TT>. 
<LI> <TT>UPNP_E_OUTOF_MEMORY</TT>: Insufficient resources exist to 
complete this operation.
<LI> <TT>UPNP_SOAP_E_INVALID_VAR</TT>: The given variable is invalid 
according to the device.
</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>