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>AddPostDataRaw</title> 8 </head> 9 <body> 10<h1><CODE>nn::http::Connection::AddPostDataRaw</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> AddPostDataRaw( 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>ResultPostAddedAnotherErr</th> 56<td><CODE>POST</CODE> data has already been configured. The function returns this value when <CODE>POST</CODE> data of a different type has already been configured, if <CODE>POST</CODE> data of the <CODE>Raw</CODE> type has already been configured, or if adding <CODE>POST</CODE> data when in the <a href="../../../nn/http/Connection/SetLazyPostDataSetting.html"><CODE>SetLazyPostDataSetting</CODE></a> mode. Use this function carefully to not conflict with such <CODE>POST</CODE> data configuration. (To reconfigure <CODE>POST</CODE> data, 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>ResultOutOfMemoryErr</th> 60<td>Could not allocate <CODE>POST</CODE> data buffer from the buffer configured by the <a href="../../../nn/http/Initialize.html"><CODE>nn::http::Initialize</CODE></a> function. Adjust the total size of the <CODE>POST</CODE> data being registered simultaneously to fit within the the buffer configured by the <a href="../../../nn/http/Initialize.html"><CODE>nn::http::Initialize</CODE></a> function.</td> 61 </tr> 62 <tr> 63<th>ResultConnectionStatusErr</th> 64<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 already connected. You must call this function before calling <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>.)</td> 65 </tr> 66 <tr> 67<th>ResultInvalidParamErr</th> 68<td>Error indicating an invalid parameter. Specify valid values for all parameters and call this function again.</td> 69 </tr> 70 <tr> 71<th>ResultNotConnectedErr</th> 72<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> 73 </tr> 74 <tr> 75<th>ResultNotInitializedErr</th> 76<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> 77 </tr> 78 <tr> 79<th>A value other than the above.</th> 80<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td> 81 </tr> 82 </table> </div> 83<h2>Description</h2> 84 <div class="section"> 85<p>Function used to configure raw POST data before <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>ing.</p><p>Batch-sets all POST data to send in an HTTP request.<br />This function configures all POST data as direct raw data in binary format.<br />(Other similar functions set the label and value portions of the POST data.)<br /><br />Use this function for settings before running <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>.<br />The POST data is sent by running the <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a> function after configuring the settings.<br /><br />Because this function configures all the POST data, an error is returned if a function that configures partial POST data (that is, <a href="../../../nn/http/Connection/AddPostDataAscii.html"><CODE>AddPostDataAscii</CODE></a> or <a href="../../../nn/http/Connection/AddPostDataBinary.html"><CODE>AddPostDataBinary</CODE></a>) is called after this function is used to configure all the POST data. (The <CODE>Description</CODE> of this error is <CODE>nn::http::ER_POST_ADDED_ANOTHER</CODE>.)<br />If this function is called multiple times to configure raw data, data that was set during previous calls is discarded and updated to the data from the most recent call.<br /></p><!-- write here --></div> 86<h2>Revision History</h2> 87 <div class="section"> 88 <dl class="history"> 89 <dt>2010/06/14</dt> 90<dd>Initial version.<br /> 91 </dd> 92 </dl> 93 </div> 94 <hr><p>CONFIDENTIAL</p></body> 95</html>