pupnp (libupnp) snapshot from SourceForge: git clone git://pupnp.git.sourceforge...
[igd2-for-linux:wanipconnection2.git] / pupnp_branch-1.6.x / docs / dist / html / upnp / UpnpOpenHttpPost.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
3 <HTML>
4 <HEAD>
5    <TITLE>EXPORT_SPEC int UpnpOpenHttpPost</TITLE>
6    <META NAME="GENERATOR" CONTENT="DOC++ 3.4.10">
7 </HEAD>
8 <BODY BGCOLOR="#ffffff">
9
10 <H2>EXPORT_SPEC int <A HREF="#DOC.DOCU">UpnpOpenHttpPost</A></H2><H2>( IN const char* url,<BR>&nbsp;  IN OUT void** handle,<BR>&nbsp;  IN const char* contentType,<BR>&nbsp;  IN int contentLength,<BR>&nbsp;  IN int timeout )</H2><BLOCKQUOTE><B>UpnpOpenHttpPost</B> makes an HTTP POST request message, opens a  connection to the server and sends the POST request to the server if  the connection to the server succeeds.</BLOCKQUOTE>
11
12 <A NAME="DOC.DOCU"></A>
13 <HR>
14 <H2>Documentation</H2>
15 <BLOCKQUOTE><B>UpnpOpenHttpPost</B> makes an HTTP POST request message, opens a 
16 connection to the server and sends the POST request to the server if 
17 the connection to the server succeeds.
18 The SDK allocates the memory for <B>handle</B> and 
19 <B>contentType</B>, the application is responsible for freeing this memory.
20
21 <P></BLOCKQUOTE>
22 <DL><DT><DT><B>Parameters:</B><DD><B>url</B> -   The URL in which to send the POST 
23 request. 
24 <BR><B>handle</B> -   A pointer in which to store the 
25 handle for this connection.  This 
26 handle is required for futher 
27 operations over this connection. 
28 <BR><B>contentType</B> -   A buffer to store the media type of 
29 content being sent.  
30 <BR><B>contentLength</B> -   The length of the content, in bytes, 
31 being posted. 
32 <BR><B>timeout</B> -   The time out value sent with the 
33 request during which a response is 
34 expected from the receiver, failing 
35 which, an error is reported. <BR><DT><B>Returns:</B><DD>  [int] An integer representing one of the following:
36 <UL>
37 <LI> <TT>UPNP_E_SUCCESS</TT>: The operation completed successfully.
38 <LI> <TT>UPNP_E_INVALID_PARAM</TT>: Either <B>url</B>, <B>handle</B> 
39 or <B>contentType</B> is not a valid pointer.
40 <LI> <TT>UPNP_E_INVALID_URL</TT>: The <B>url</B> is not a valid 
41 URL.
42 <LI> <TT>UPNP_E_OUTOF_MEMORY</TT>: Insufficient resources exist to 
43 download this file.
44 <LI> <TT>UPNP_E_SOCKET_ERROR</TT>: Error occured allocating a socket and 
45 resources or an error occurred binding a socket.
46 <LI> <TT>UPNP_E_SOCKET_WRITE</TT>: An error or timeout occurred writing 
47 to a socket.
48 <LI> <TT>UPNP_E_SOCKET_CONNECT</TT>: An error occurred connecting a 
49 socket.
50 <LI> <TT>UPNP_E_OUTOF_SOCKET</TT>: Too many sockets are currently 
51 allocated.
52 </UL>
53 <BR><DD></DL><P><P><I><A HREF="index.html">Alphabetic index</A></I></P><HR>
54 <BR>
55 This page was generated with the help of <A HREF="http://docpp.sourceforge.net">DOC++</A>.
56 </BODY>
57 </HTML>