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><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/http/Overview.html">http</a>::<a href="../../../nn/http/Connection/Overview.html">Connection</a>::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 one of the <a href="../../../nn/Result/Overview.html"><CODE>Result</CODE></a> values listed below.<br /><br /> <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>Result::IsSuccess</CODE></th> 58<td>Process was successful.</td> 59 </tr> 60 <tr> 61<th><CODE>ResultPostAddedAnotherErr</CODE></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. When calling this function, be sure to avoid conflicts with these <CODE>POST</CODE> data settings. (To reconfigure <CODE>POST</CODE> data, first call the <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> object'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><CODE>ResultOutOfMemoryErr</CODE></th> 66<td>Could not allocate a <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><CODE>ResultConnectionStatusErr</CODE></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><CODE>ResultInvalidParamErr</CODE></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><CODE>ResultNotConnectedErr</CODE></th> 78<td>Error indicating that no target URL was assigned to the <CODE>Connection</CODE> object. No action is performed because the <CODE>Connection</CODE> object has not been initialized by a successful call of <a href="../../../nn/ssl/Connection/Initialize.html"><CODE>Initialize</CODE></a>.</td> 79 </tr> 80 <tr> 81<th><CODE>ResultNotInitializedErr</CODE></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> 102