1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<meta http-equiv="Content-Style-Type" content="text/css">
7<link rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<title>NHTTPError</title>
9</head>
10
11<body>
12
13<h1>NHTTPError</h1>
14
15<h2>Syntax</h2>
16<dl><dd><pre><code>
17#include &lt;revolution/nhttp/NHTTPStartup.h&gt;
18
19typedef enum {
20    NHTTP_ERROR_SYSTEM = -1,
21
22    NHTTP_ERROR_NONE = 0,
23    NHTTP_ERROR_ALLOC,
24    NHTTP_ERROR_TOOMANYREQ,
25    NHTTP_ERROR_SOCKET,
26    NHTTP_ERROR_DNS,
27    NHTTP_ERROR_CONNECT,
28    NHTTP_ERROR_BUFFULL,
29    NHTTP_ERROR_HTTPPARSE,
30    NHTTP_ERROR_CANCELED,
31    NHTTP_ERROR_REVOLUTIONSDK,
32    NHTTP_ERROR_REVOLUTIONWIFI,
33    NHTTP_ERROR_UNKNOWN,
34    NHTTP_ERROR_DNS_PROXY,
35    NHTTP_ERROR_CONNECT_PROXY,
36    NHTTP_ERROR_SSL,
37    NHTTP_ERROR_BUSY,
38    NHTTP_ERROR_SSL_ROOTCA,
39    NHTTP_ERROR_SSL_CLIENTCERT,
40
41    NHTTP_ERROR_MAX
42} NHTTPError;
43</code></pre></dd></dl>
44
45<h2>Description</h2>
46Error enumeration type defined by the NHTTP library.<br>The enumerator values are as follows:
47<p>
48<table border="1" >
49  <tr>
50<td valign="top" width="120" bgcolor="#ffe8ff"><strong><em>Definitions</em></strong></td>
51<td bgcolor="#ffe8ff">Value</td>
52<td width="520" bgcolor="#ffe8ff">Description</td>
53  </tr>
54  <tr>
55<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_SYSTEM</em></strong></td>
56    <td>-1</td>
57<td width="520">Error resulting from an invalid handle.<br>Returned when the connection handle passed by the argument is invalid.
58  </tr>
59        <tr></tr>
60        <tr>
61<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_NONE</em></strong></td>
62    <td>0</td>
63<td width="520">Successful.</td>
64  </tr>
65  <tr>
66<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_ALLOC</em></strong></td>
67    <td>1</td>
68    <td>
69Allocation has failed.<br><br>Check the memory allocation and deallocation functions set in <a href="NHTTPStartup.html"><CODE>NHTTPStartup</CODE></a>.</td>
70  </tr>
71  <tr>
72<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_TOOMANYREQ</em></strong></td>
73    <td>2</td>
74<td>Too many requests.</td>
75  </tr>
76  <tr>
77<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_SOCKET</em></strong></td>
78    <td>3</td>
79<td>Socket error.<br> This error is returned when socket creation fails or when a negative value is returned by the set callback while determining the POST data send size for streaming sends.</td>
80  </tr>
81  <tr>
82<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_DNS</em></strong></td>
83    <td>4</td>
84    <td>
85DNS resolution failed.<br>This is returned when the requested URL is incorrect or doesn't exist.<br>Check the requested URL.
86    </td>
87  </tr>
88  <tr>
89<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_CONNECT</em></strong></td>
90    <td>5</td>
91    <td>
92Connection failure.<br>Returned when communication is blocked after DNS resolution but before connecting to the requested URL's server, or when the connection port number specified by the requested URL is wrong.
93    </td>
94  </tr>
95  <tr>
96<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_BUFFULL</em></strong></td>
97    <td>6</td>
98<td>The receive buffer is full.</td>
99  </tr>
100  <tr>
101<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_HTTPPARSE</em></strong></td>
102    <td>7</td>
103    <td>
104HTTP header parsing failed.<br>Returned when there is a problem with the HTTP header received from the server.</td>
105  </tr>
106  <tr>
107<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_CANCELED</em></strong></td>
108    <td>8</td>
109<td>The request was canceled.</td>
110  </tr>
111  <tr>
112<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_REVOLUTIONSDK</em></strong></td>
113    <td>9</td>
114    <td>
115NHTTP thread generation failed.<br><br>Returned when thread generation fails while running <a href="NHTTPStartup.html"><CODE>NHTTPStartup</CODE></a>.</td>
116  </tr>
117  <tr>
118<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_REVOLUTIONWIFI</em></strong></td>
119    <td>10</td>
120<td>There was a problem when sending or receiving, or when the socket closed.<br> Returned when communication is blocked during sending, receiving, or termination. </td>
121  </tr>
122  <tr>
123<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_UNKNOWN</em></strong></td>
124    <td>11</td>
125<td>Another request start is required for the currently executing request.</td>
126  </tr>
127  <tr>
128<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_DNS_PROXY</em></strong></td>
129    <td>12</td>
130    <td>
131DNS resolution failed for the proxy server.<br>Returned when the proxy server configured in the Wii console settings is incorrect or doesn't exist.<br>Check the proxy server settings in the Wii console.</td>
132  </tr>
133  <tr>
134<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_CONNECT_PROXY</em></strong></td>
135    <td>13</td>
136    <td>
137Connection with the proxy server failed.<br> Returned when communication is blocked after DNS resolution but before connecting to the proxy server. Also returned when the connection port number, specified by the Wii console setting's proxy server, is wrong.</td>
138  </tr>
139  <tr>
140<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_SSL,</em></strong></td>
141    <td>14</td>
142    <td>
143SSL communications failed.<br> Returned if connection with a server by SSL communication  fails.</td>
144  </tr>
145  <tr>
146<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_BUSY</em></strong></td>
147    <td>15</td>
148<td>Indicates that a request is currently running.</td>
149  </tr>
150  <tr>
151<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_SSL_ROOTCA</em></strong></td>
152    <td>16</td>
153<td>Root CA configuration failed.</td>
154  </tr>
155  <tr>
156<td valign="top" width="120" bgcolor="#ffffe8"><strong><em>NHTTP_ERROR_SSL_CLIENTCERT</em></strong></td>
157    <td>17</td>
158<td>Client certificate configuration failed.</td>
159  </tr>
160</table>
161<h2>Revision History</H2>
162<p>2008/02/01 Initial version.</p>
163
164<hr><p>CONFIDENTIAL</p></body>
165</html>
166