1<!DOCTYPE HTML PUBLIC "-//W3C//Dtd HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<link rel="stylesheet" type="text/css" href="../CSS/rex.css" />
7<title>WDTryUsbApRegistrationOnce</title>
8</head>
9<body>
10
11<h1>WDTryUsbApRegistrationOnce</h1>
12
13<h2>C Specification</h2>
14
15<dl>
16  <dd><pre><code>#include &lt;revolution/wd/WDScan.h&gt;</code></pre>
17  </dd>
18  <dd><pre><code>BOOL WDTryUsbApRegistrationOnce( u16 <em>usbapChannels</em>,
19                                 BOOL <em>usbapSignal</em>,
20                                 const u8* <em>usbapNickname</em> );</code></pre>
21  </dd>
22</dl>
23
24<h2>Description</h2>
25<p>
26	Attempts a user registration once on the Nintendo Wi-Fi USB Connector.<br>Internally, the <CODE>WDTryUsbApRegistrationOnce</CODE> function calls the <CODE><a href="WDScanOnce.html">WDScanOnce</a></CODE> function, and blocks until a single attempt at registration is completed.
27</p>
28<p>
29	Registration requires the use of a user registration tool on the PC, so it is possible that the first attempt may fail.<br>In addition, registration occurs using the MAC address from the device's wireless modules as a key, so only one user can register from a single device. Multiple registrations from the same device will result in the overwriting of previous registrations.
30</p>
31
32<h2>Arguments</h2>
33<table border="1" cellpadding="3" cellspacing="0.1">
34	<tr>
35		<TH><em>usbapChannels</em></TH>
36		<TD>
37			Specifies the wireless channel list for the registration attempt in bit field format.<br>As you cannot normally specify the wireless channel on which the Nintendo Wi-Fi USB Connector is running, use the <CODE><a href="WDCheckEnableChannel.html">WDCheckEnableChannel</a></CODE> function to specify all available channels.
38		</TD>
39	</tr>
40	<tr>
41		<TH><em>usbapSignal</em></TH>
42		<TD>
43			Specifies whether a one-time action display will occur in the user registration tool on the PC during the registration attempt.
44			<table border="1" cellpadding="3" cellspacing="0.1">
45				<tr>
46					<TH>TRUE</TH>
47					<TD>A one-time action display will occur.</TD>
48				</tr>
49				<tr>
50					<TH>FALSE</TH>
51					<TD>A one-time action display will not occur.</TD>
52				</tr>
53			</table>
54		</TD>
55	</tr>
56	<tr>
57		<TH><em>usbapNickname</em></TH>
58		<TD>
59			Specifies the nickname for the user attempting registration. If there is already a registered nick name, it will be overwritten.<br>The nickname format is a little-endian UTF-16 string up to 20 bytes in length. For shorter nicknames, use null-padding to reach a length of 20 bytes.
60		</TD>
61	</tr>
62</table>
63
64<h2>Return Values</h2>
65<table border="1" cellpadding="3" cellspacing="0.1">
66	<tr>
67		<TH>TRUE</TH>
68		<TD>Registration successful.</TD>
69	</tr>
70	<tr>
71		<TH>FALSE</TH>
72		<TD>
73			Registration failed.<br>Detailed reasons for the failure are not available. It is possible that the Nintendo Wi-Fi USB Connector was not found, or that, even when found, communications were denied.
74		</TD>
75	</tr>
76</table>
77
78<h2>See Also</h2>
79<p>
80	<CODE><a href="WDCheckEnableChannel.html">WDCheckEnableChannel</a><br></CODE>
81</p>
82
83<h2>Revision History</h2>
84<p>
85	2006/12/12 Added description.<br>2006/11/09 Initial version.
86</p>
87<hr><p>CONFIDENTIAL</p></body>
88</html>
89