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::Connection::Initialize</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> Initialize(
15     const char * pUrl,
16     <a href="../../../nn/http/RequestMethod.html">RequestMethod</a> method = REQUEST_METHOD_GET,
17     bool isUseDefaultProxy = true
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>pUrl</th>
34<td>URL string for host to communicate with.</td>
35        </tr>
36        <tr>
37<td>in</td>
38<th>method</th>
39<td>HTTP request method (if unspecified, <CODE>nn::http::REQUEST_METHOD_GET</CODE> is used by default).)</td>
40        </tr>
41        <tr>
42<td>in</td>
43<th>isUseDefaultProxy</th>
44<td>Specifies whether to use the default proxy settings that are configured for the device. (Specify <CODE>true</CODE> to use the default proxy settings. If unspecified, this value will default to <CODE>true</CODE>.)</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>ResultConnectionAddErr</th>
62<td>Error indicating that the maximum number of manageable HTTP sessions are already in use by the device, and no more can be allocated. This function can be used once another HTTP session finishes, so try again later after another module finishes with an HTTP session, or after closing another local <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class instance by calling <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a>.</td>
63        </tr>
64        <tr>
65<th>ResultRequestUrlErr</th>
66<td>Error indicating that the specified URL is invalid. Specify a valid URL and call this function again.</td>
67        </tr>
68        <tr>
69<th>ResultAlreadyAssignHostErr</th>
70<td>Error indicating that the remote host has already been allocated. This function has already been run for this <CODE>Connection</CODE> instance, and the URL is already configured. Use this instance as-is to connect with the previously configured URL. To change the URL, you must call this function again after first calling <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a>.</td>
71        </tr>
72        <tr>
73<th>ResultConnectionProcessMaxErr</th>
74<td>Error indicating that the maximum number of connections used by one process has been reached. This function can be used once another HTTP session finishes, so try again after closing another local <a href="../../../nn/http/Connection/Overview.html"><CODE>Connection</CODE></a> class instance by calling <a href="../../../nn/http/Connection/Finalize.html"><CODE>Finalize</CODE></a>.</td>
75        </tr>
76        <tr>
77<th>ResultIpcSessionMaxErr</th>
78<td>Error indicating that the maximum number of IPC sessions are already connected. Trying again later may succeed (provided another IPC session succeeds in the meantime).</td>
79        </tr>
80        <tr>
81<th>ResultInvalidParamErr</th>
82<td>Error indicating an invalid parameter. Specify valid values for all parameters and call this function again.</td>
83        </tr>
84        <tr>
85<th>ResultNotInitializedErr</th>
86<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>
87        </tr>
88        <tr>
89<th>A value other than the above.</th>
90<td>Unexpected error (See <CODE>http_Result.h</CODE> for details).</td>
91        </tr>
92      </table> </div>
93<h2>Description</h2>
94    <div class="section">
95<p>Initializes a <a href="../../../nn/http/Connection/Overview.html">Connection</a> and assigns a URL and method to it.</p><!-- write here --></div>
96<h2>Revision History</h2>
97    <div class="section">
98      <dl class="history">
99        <dt>2010/06/14</dt>
100<dd>Initial version.<br />
101        </dd>
102      </dl>
103    </div>
104  <hr><p>CONFIDENTIAL</p></body>
105</html>