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>AddPostDataAscii</title> 8 </head> 9 <body> 10<h1><CODE>nn::http::Connection::AddPostDataAscii</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> AddPostDataAscii( 15 const char * pLabel, 16 const char * pValue 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>pLabel</th> 33<td>Label name of the data.</td> 34 </tr> 35 <tr> 36<td>in</td> 37<th>pValue</th> 38<td>Data content.</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, 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 POST data before <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>ing (for ASCII strings).</p><p>Adds POST data (ASCII strings) to send through an HTTP request.<br />Use this function for the settings that are active before running <a href="../../../nn/http/Connection/Connect.html"><CODE>Connect</CODE></a>. 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 is already added before the call, the data is updated. (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 all POST data is set using only the <a href="../../../nn/http/Connection/AddPostDataAscii.html"><CODE>AddPostDataAscii</CODE></a> function, the labels and the data of the outgoing data are both encoded before they are sent. (In this case, the <CODE>Content-Type</CODE> value in the HTTP header is set to <CODE>"x-www-form-urlencoded"</CODE>.)<br /><br />If any of the data (even a single item) is set with <a href="../../../nn/http/Connection/AddPostDataBinary.html"><CODE>AddPostDataBinary</CODE></a>, all POST data is sent without being encoded. (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> 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>