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>Initialize</title>
8  </head>
9  <body>
10<h1><CODE>nn::http::Initialize</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../nn/Result/Overview.html">Result</a> Initialize(
15     uptr bufferAddress = 0,
16     size_t bufferSize = 0
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>bufferAddress</th>
33<td>Pointer to the start of the buffer for POST data.  The memory for the buffer must be 4096-byte aligned.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>bufferSize</th>
38<td>Size of the buffer for POST data.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the processing result.<br /> </div>
43<h2>Description</h2>
44    <div class="section">
45<p>Initializes the HTTP library. Processes linking the HTTP library must call this once before using the library.</p><p>You must set the argument to the buffer for POST data in order to use the <CODE>AddPostData</CODE>-related functions of <CODE><a href="../../nn/http/Connection/Overview.html">nn::http::Connection</a></CODE> (the functions that register POST data before <CODE>Connect</CODE>). <br />If you are not using the <CODE>AddPostData</CODE>-related functions you do not need to set anything to the argument.  (In other words, even if POST data are being used, this argument does not need to be set if the POST data are being used only with  <CODE>SendPostData</CODE>-related functions. <br /><br /> The POST data buffer is used to temporarily store the registered POST data.<br /> For this reason, the buffer size must be larger than the maximum total amount of POST data that will be registered at any one time. <br />(The POST data registered to <CODE><a href="../../nn/http/Connection/Overview.html">nn::http::Connection</a></CODE> are stored temporarily in the POST data buffer, POST-sent when <CODE><a href="../../nn/http/Connection/Connect.html">nn::http::Connection::Connect</a></CODE> executes, and deleted when <CODE><a href="../../nn/http/Connection/Finalize.html">nn::http::Connection::Finalize</a></CODE> executes.   Accordingly, the size of the POST data buffer must be larger than the maximum total amount of POST data that will be registered to <CODE><a href="../../nn/http/Connection/Overview.html">nn::http::Connection</a></CODE> at any one time together before <CODE>Finalize</CODE>.)</p><!-- write here --></div>
46<h2>Revision History</h2>
47    <div class="section">
48      <dl class="history">
49        <dt>2010/06/14</dt>
50<dd>Initial version.<br />
51        </dd>
52      </dl>
53    </div>
54  <hr><p>CONFIDENTIAL</p></body>
55</html>