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>AddPostDataBinary</title> 8 </head> 9 <body> 10<h1><CODE>nn::http::Connection::AddPostDataBinary</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> AddPostDataBinary( 15 const char * pLabel, 16 const void * pValue, 17 size_t valueSize 18); 19</pre> 20 </div> 21<h2>Arguments</h2> 22 <div class="section"> 23 <table class="arguments"> 24 <thead> 25 <tr> 26 <td width="15" /> 27<th>Name</th> 28<td>Description</td> 29 </tr> 30 </thead> 31 <tr> 32<td>in</td> 33<th>pLabel</th> 34<td>Label name of the data.</td> 35 </tr> 36 <tr> 37<td>in</td> 38<th>pValue</th> 39<td>Data content.</td> 40 </tr> 41 <tr> 42<td>in</td> 43<th>valueSize</th> 44<td>Data size of <SPAN class="argument">pValue</SPAN>.</td> 45 </tr> </table> 46 </div> 47<h2>Return Values</h2> 48<div class="section">Returns the function's execution result. Returns a <CODE><a href="../../../nn/Result/Overview.html">Result</A></CODE> listed below. <br /> 49 <table class="arguments"> 50 <thead> 51 <tr> 52<th>Value</th> 53<td>Description</td> 54 </tr> 55 </thead> 56 <tr> 57<th><CODE>ResultSuccess</CODE></th> 58<td>Process was successful.</td> 59 </tr> 60 <tr> 61<th>ResultPostAddedAnotherErr</th> 62<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, 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> 63 </tr> 64 <tr> 65<th>ResultOutOfMemoryErr</th> 66<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> 67 </tr> 68 <tr> 69<th>ResultConnectionStatusErr</th> 70<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> 71 </tr> 72 <tr> 73<th>ResultInvalidParamErr</th> 74<td>Error indicating an invalid parameter. Specify valid values for all parameters and call this function again.</td> 75 </tr> 76 <tr> 77<th>ResultNotConnectedErr</th> 78<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> 79 </tr> 80 <tr> 81<th>ResultNotInitializedErr</th> 82<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> 83 </tr> 84 <tr> 85<th>A value other than the above.</th> 86<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td> 87 </tr> 88 </table> </div> 89<h2>Description</h2> 90 <div class="section"> 91<p>Function used to configure binary POST data before <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>ing.</p><p>Adds POST data (binary data) to send through an HTTP request.<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 />If data with the same label has already been added before the call to this function, this function updates the data.<br />(In other words, if data with the same label is added twice, the old value is deleted before the new value is added.）<br /><br />If any of the data is set with <a href="../../../nn/http/Connection/AddPostDataBinary.html"><CODE>AddPostDataBinary</CODE></a>, all POST data is sent without being encoded.<br />(In this case, the <CODE>Content-Type</CODE> value in the HTTP header is set to <CODE>"multipart/form-data"</CODE>.)<br /></p><!-- write here --></div> 92<h2>Revision History</h2> 93 <div class="section"> 94 <dl class="history"> 95 <dt>2010/06/14</dt> 96<dd>Initial version.<br /> 97 </dd> 98 </dl> 99 </div> 100 <hr><p>CONFIDENTIAL</p></body> 101</html>