1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml"> 3 <head> 4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 5 <meta http-equiv="Content-Style-Type" content="text/css" /> 6 <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" /> 7<title>SendPostDataRaw</title> 8 </head> 9 <body> 10<h1><CODE>nn::http::Connection::SendPostDataRaw</CODE> Member Function</h1> 11<h2>Syntax</h2> 12 <div class="section"> 13 <pre class="definition"> 14<a href="../../../nn/Result/Overview.html">nn::Result</a> SendPostDataRaw( 15 const void * pValue, 16 size_t valueSize 17); 18</pre> 19 </div> 20<h2>Arguments</h2> 21 <div class="section"> 22 <table class="arguments"> 23 <thead> 24 <tr> 25 <td width="15" /> 26<th>Name</th> 27<td>Description</td> 28 </tr> 29 </thead> 30 <tr> 31<td>in</td> 32<th>pValue</th> 33<td>Data content.</td> 34 </tr> 35 <tr> 36<td>in</td> 37<th>valueSize</th> 38<td>Data size of <SPAN class="argument">pValue</SPAN>.</td> 39 </tr> </table> 40 </div> 41<h2>Return Values</h2> 42<div class="section">Returns the function's execution result. Returns a <CODE><a href="../../../nn/Result/Overview.html">Result</A></CODE> listed below. <br /> 43 <table class="arguments"> 44 <thead> 45 <tr> 46<th>Value</th> 47<td>Description</td> 48 </tr> 49 </thead> 50 <tr> 51<th><CODE>ResultSuccess</CODE></th> 52<td>Process was successful.</td> 53 </tr> 54 <tr> 55<th>ResultSocketKeepAliveDisconnected</th> 56<td>Error indicating that the server disconnected the keep-alive connection. The HTTP library usually reconnects automatically in such cases, but if set to the <a href="../../../nn/http/Connection/SetLazyPostDataSetting.html"><CODE>SetLazyPostDataSetting</CODE></a> mode, the HTTP library does not automatically reconnect to resend <CODE>POST</CODE> data and instead returns this error. To reconnect, first call the <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class's <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a> function, and then call <a href="../../../nn/http/Connection/Initialize.html"><CODE>Initialize</CODE></a> again.</td> 57 </tr> 58 <tr> 59<th>ResultSocketSendErr</th> 60<td>Error indicating failure to send socket data. This could be because the server disconnected. To reconnect, first call the <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class's <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a> function, and then call <a href="../../../nn/http/Connection/Initialize.html"><CODE>Initialize</CODE></a> again.</td> 61 </tr> 62 <tr> 63<th>ResultSocketConnectErr</th> 64<td>Error indicating failure to connect to socket. This could be because the server does not exist or is not running. To reconnect, first call the <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class's <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a> function, and then call <a href="../../../nn/http/Connection/Initialize.html"><CODE>Initialize</CODE></a> again.</td> 65 </tr> 66 <tr> 67<th>ResultDnsResolutionErr</th> 68<td>Error indicating that name resolution failed for the host name specified in the URL.</td> 69 </tr> 70 <tr> 71<th>ResultConnectionCanceledErr</th> 72<td>Error indicating that the connection was canceled. To reconnect, first call the <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class's <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a> function, and then call <a href="../../../nn/http/Connection/Initialize.html"><CODE>Initialize</CODE></a> again.</td> 73 </tr> 74 <tr> 75<th>ResultConnectionStatusErr</th> 76<td>Error indicating an invalid state. This function cannot be called in the current communication state. (For example, the function returns this error if the system is not yet connected. You must call this function after calling <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>.)</td> 77 </tr> 78 <tr> 79<th>ResultNotConnectedErr</th> 80<td>Error indicating a <CODE>Connection</CODE> class instance for which the target URL is not assigned. The function has not done anything as it has been called on a <CODE>Connection</CODE> instance for which you have not yet successfully called <a href="../../../nn/http/Connection/Initialize.html"><CODE>Initialize</CODE></a>.</td> 81 </tr> 82 <tr> 83<th>ResultNotInitializedErr</th> 84<td>Error indicating that the library is not initialized. None of this library's functions can be used until you first call <a href="../../../nn/http/Initialize.html"><CODE>nn::http::Initialize</CODE></a>.</td> 85 </tr> 86 <tr> 87<th>A value other than the above.</th> 88<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td> 89 </tr> 90 </table> </div> 91<h2>Description</h2> 92 <div class="section"> 93<p>Function used to set POST data (as raw data) in "lazy" (delayed) POST data configuration mode.</p><p>In "lazy" POST data configuration mode, which can be entered by calling <a href="../../../nn/http/Connection/SetLazyPostDataSetting.html"><CODE>SetLazyPostDataSetting</CODE></a>, this function can be used after either <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a> or <a href="../../../nn/http/Connection/ConnectAsync.html"><CODE>ConnectAsync</CODE></a> is called. For more information about "lazy" POST data configuration mode, see the description of the <a href="../../../nn/http/Connection/SetLazyPostDataSetting.html"><CODE>SetLazyPostDataSetting</CODE></a> function.</p><p><B>Note:</B> Unlike the version of <CODE><a href="../../../nn/http/Connection/SendPostDataRaw.html">SendPostDataRaw</a></CODE> that includes a timeout, this function does not time out. In other words, control will not return from this function until processing has ended. In environments where communications are slow you can expect a long time to pass before processing ends and control returns from this function.<br /></p><!-- write here --></div> 94<h2>Revision History</h2> 95 <div class="section"> 96 <dl class="history"> 97 <dt>2010/06/14</dt> 98<dd>Initial version.<br /> 99 </dd> 100 </dl> 101 </div> 102 <hr><p>CONFIDENTIAL</p></body> 103</html>