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>Connect</title>
8  </head>
9  <body>
10<h1><CODE>nn::ac::CTR::Connect</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">Result</a> Connect(
15<a href="../../../nnacConfig/Overview.html">Config</a> & config
16);
17</pre>
18    </div>
19<h2>Arguments</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>config</th>
32<td>Instance of connection conditions.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">The result.<br /> <br />
37      <table class="arguments">
38        <thead>
39          <tr>
40<th>Value</th>
41<td>Description</td>
42          </tr>
43        </thead>
44        <tr>
45<th><CODE>ResultLanConnected</CODE></th>
46<td>Successfully connected to a LAN.</td>
47        </tr>
48        <tr>
49<th><CODE>ResultWanConnected</CODE></th>
50<td>Successfully connected to a WAN.</td>
51        </tr>
52        <tr>
53<th><CODE>nn::fs::ResultNotInitialized</CODE></th>
54<td>The FS library has not been initialized.</td>
55        </tr>
56        <tr>
57<th><CODE>ResultNotFoundAccessPoint</CODE></th>
58<td>Unable to find an access point that could be connected to.</td>
59        </tr>
60        <tr>
61<th><CODE>ResultCanceled</CODE></th>
62<td>Canceled while a connection was being processed.</td>
63        </tr>
64        <tr>
65<th><CODE>ResultAlreadyExists</CODE></th>
66<td>Already processing.</td>
67        </tr>
68        <tr>
69<th><CODE>ResultNotAgreeEula</CODE></th>
70<td>The EULA has not been agreed to, or the icon file has not been configured.</td>
71        </tr>
72        <tr>
73<th><CODE>ResultAlreadyConnectUnsupportAp</CODE></th>
74<td>Connecting to an unusable AP.</td>
75        </tr>
76        <tr>
77<th><CODE>ResultWifiOff</CODE></th>
78<td>Cannot use a network because the system is in &quot;flight mode.&quot;</td>
79        </tr>
80        <tr>
81<th><CODE>ResultFailedScan</CODE></th>
82<td>Failed scan.</td>
83        </tr>
84        <tr>
85<th><CODE>ResultConflictIpAddress</CODE></th>
86<td>Conflicting IP address.</td>
87        </tr>
88        <tr>
89<th><CODE>ResultFailedDhcp</CODE></th>
90<td>DHCP failure.</td>
91        </tr>
92        <tr>
93<th><CODE>ResultInvalidDns</CODE></th>
94<td>Name resolution failure.</td>
95        </tr>
96        <tr>
97<th><CODE>ResultInvalidProxy</CODE></th>
98<td>Proxy failure.</td>
99        </tr>
100        <tr>
101<th><CODE>ResultFailedConnTest</CODE></th>
102<td>Failed Internet connection test.</td>
103        </tr>
104        <tr>
105<th><CODE>ResultFailedHotspotAuthentication</CODE></th>
106<td>Failed hotspot authentication.</td>
107        </tr>
108        <tr>
109<th><CODE>ResultFailedHotspotConntest</CODE></th>
110<td>Passed hotspot authentication and then failed an Internet connection test.</td>
111        </tr>
112        <tr>
113<th><CODE>ResultOutOfMemory</CODE></th>
114<td>Failed to allocate memory.</td>
115        </tr>
116        <tr>
117<th><CODE>ResultUnsupportAuthAlgorithm</CODE></th>
118<td>Could not connect to an access point because it used an unsupported encryption scheme.</td>
119        </tr>
120        <tr>
121<th><CODE>ResultDenyUsbAp</CODE></th>
122<td>Access to a Nintendo Wi-Fi USB Connector was denied.</td>
123        </tr>
124        <tr>
125<th><CODE>ResultUnsupportPlace</CODE></th>
126<td>Could not connect because the network is unusable from the current location.</td>
127        </tr>
128        <tr>
129<th>A value other than the above.</th>
130<td>Failed for reasons other than those given above.</td>
131        </tr>
132      </table> </div>
133<h2>Description</h2>
134    <div class="section">
135<p>Starts an automatic connection.</p><p>Use this only after you have called the <a href="../../../nn/fs/Initialize.html"><CODE>nn::fs::Initialize</CODE></a> function.</p><p>Once a connection is established, the <CODE><a href="../../../nn/os/LightEvent/Overview.html">nn::os::LightEvent</a></CODE> registered by <CODE>nn::ac::RegisterDisconnectEvent</CODE> is signaled if the system is accidentally disconnected from the access point. This function gets the application's EULA version, so it returns <a href="../../../nn/ac/ResultNotAgreeEula/Overview.html"><CODE>ResultNotAgreeEula</CODE></A> if the icon file is not configured.</p><!-- write here --></div>
136<h2>Revision History</h2>
137    <div class="section">
138      <dl class="history">
139        <dt>2010/11/18</dt>
140<dd>Added the fact that this function gets the application's EULA information.
141<br />        </dd>
142        <dt>2010/06/14</dt>
143<dd>Initial version.<br />
144        </dd>
145      </dl>
146    </div>
147  <hr><p>CONFIDENTIAL</p></body>
148</html>
149