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<title>NETGetStartupErrorCode</title>
8<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
9</head>
10
11<body>
12
13<h1 align="left">NETGetStartupErrorCode</h1>
14<h2>Syntax</h2>
15<dl>
16  <dd>
17  <PRE><CODE>#include &lt;revolution/net.h&gt;
18
19s32 NETGetStartupErrorCode( s32 soErr );
20</CODE></PRE>
21  </dd>
22</dl>
23<h2>Arguments</h2>
24<table border="1" width="100%">
25  <TR>
26<TD width="176"><em><strong><font face="Courier New">soErr</font></strong></em></TD>
27<TD width="670">The return value from the <CODE>SOStartup</CODE> function.</TD>
28  </TR>
29</table>
30<h2>Return Values</h2>
31<p>Returns a value equal to -1 multiplied by the five-digit error code displayed for the user, corresponding to the error value returned by the <CODE>SOStartup</CODE> function.</p>
32<H2>Description</H2>
33<p>This function converts the error value returned by the <CODE>SOStartup</CODE> function to a five-digit error code that can be displayed to the user. The <CODE>NETGetStartupErrorCode</CODE> function determines the type of network interface currently in use internally and stores the appropriate interface type as the last two digits of the error code. Since the return value is negative, be sure to reverse positive and negative in order to obtain the actual error code displayed for the user.</p>
34<div>
35<table border="1">
36<tr><th>Interface Types</th><th>SOStartup Error Values</th><th colspan="2">Converted Error Codes</th></tr>
37<tr><td>all types</td><td>a non-error value &gt;= 0</td><td>NET_ECODE_OK</td><td>00000</td></tr>
38<tr><td>all types</td><td>SO_EFATAL</td><td>NET_ECODE_STARTUP_FAILED</td><td>50100</td></tr>
39<tr><td>all types</td><td>SO_ENOENT</td><td>NET_ECODE_NO_ENABLED_CONFIG</td><td>50200</td></tr>
40<tr><td>all types</td><td>SO_EINVAL</td><td>NET_ECODE_INVALID_CONFIG</td><td>50300</td></tr>
41<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ENXIO</td><td>NET_ECODE_DEVICE_NOT_EXISTS</td><td>504xx</td></tr>
42<tr><td>wireless</td><td>SO_ERR_LINK_UP_TIMEOUT</td><td>NET_ECODE_AP_NOT_FOUND</td><td>510xx</td></tr>
43<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ERR_LINK_UP_TIMEOUT</td><td>NET_ECODE_WIRED_LINK_UP_FAILED</td><td>514xx</td></tr>
44<tr><td>wireless</td><td>SO_ERR_LINK_DOWN</td><td>NET_ECODE_WIRELESS_LINK_UP_FAILED</td><td>513xx</td></tr>
45<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ERR_LINK_DOWN</td><td>NET_ECODE_WIRED_LINK_UP_FAILED</td><td>514xx</td></tr>
46<tr><td>wireless</td><td>SO_ENOLINK</td><td>NET_ECODE_WIRELESS_LINK_UP_FAILED</td><td>513xx</td></tr>
47<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ENOLINK</td><td>NET_ECODE_WIRED_LINK_UP_FAILED</td><td>514xx</td></tr>
48<tr><td>wireless</td><td>SO_ETIMEDOUT</td><td>NET_ECODE_WIRELESS_LINK_UP_FAILED</td><td>513xx</td></tr>
49<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ETIMEDOUT</td><td>NET_ECODE_WIRED_LINK_UP_FAILED</td><td>514xx</td></tr>
50<tr><td>wireless</td><td>SO_ENETRESET</td><td>NET_ECODE_WIRELESS_LINK_UP_FAILED</td><td>513xx</td></tr>
51<tr><td>Wii LAN adapter (Ethernet)</td><td>SO_ENETRESET</td><td>NET_ECODE_WIRED_LINK_UP_FAILED</td><td>514xx</td></tr>
52<tr><td>all types</td><td>SO_ERR_DHCP_TIMEOUT</td><td>NET_ECODE_DHCP_FAILED</td><td>520xx</td></tr>
53<tr><td>all types</td><td>SO_ERR_DHCP_EXPIRED</td><td>NET_ECODE_DHCP_FAILED</td><td>520xx</td></tr>
54<tr><td>all types</td><td>SO_ERR_DHCP_NAK</td><td>NET_ECODE_DHCP_FAILED</td><td>520xx</td></tr>
55<tr><td>all types</td><td>SO_ERR_ADDR_COLLISION</td><td>NET_ECODE_ADDR_COLLISION</td><td>527xx</td></tr>
56<tr><td>all types</td><td>all others</td><td>NET_ECODE_STARTUP_FAILED</td><td>50100</td></tr>
57</table>
58<table border="1">
59<tr><th>Interface Types</th><th>Interface Type Values</th><th>Comments</th></tr>
60<tr><td>Wii LAN adapter (Ethernet)</td><td>20~22</td><td>The last digit corresponds to the the number of the connection target setting</td></tr>
61<tr><td>wireless connection other than via the Nintendo Wi-Fi USB Connector</td><td>30~32</td><td>The last digit corresponds to the the number of the connection target setting</td></tr>
62<tr><td>Nintendo Wi-Fi USB Connector</td><td>40~42</td><td>The last digit corresponds to the the number of the connection target setting</td></tr>
63<tr><td>unknown</td><td>99</td><td></td></tr>
64</table>
65</div>
66<h2>See Also</h2>
67<P>
68None.
69</P>
70<H2>Revision History</H2>
71<P>
722008/8/4 Clarified that the return value is negative<BR> 2007/1/30 Initial version<BR>
73</P>
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76