WDTryUsbApRegistrationOnce

C Specification

#include <revolution/wd/WDScan.h>

BOOL WDTryUsbApRegistrationOnce( u16 usbapChannels,
                                 BOOL usbapSignal,
                                 const u8* usbapNickname );

Description

Attempts a user registration once on the Nintendo Wi-Fi USB Connector.
Internally, the WDTryUsbApRegistrationOnce function calls the WDScanOnce function, and blocks until a single attempt at registration is completed.

Registration requires the use of a user registration tool on the PC, so it is possible that the first attempt may fail.
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.

Arguments

usbapChannels Specifies the wireless channel list for the registration attempt in bit field format.
As you cannot normally specify the wireless channel on which the Nintendo Wi-Fi USB Connector is running, use the WDCheckEnableChannel function to specify all available channels.

usbapSignal

Specifies whether a one-time action display will occur in the user registration tool on the PC during the registration attempt.

TRUE	A one-time action display will occur.
FALSE	A one-time action display will not occur.

usbapNickname Specifies the nickname for the user attempting registration. If there is already a registered nick name, it will be overwritten.
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.

Return Values

TRUE	Registration successful.
FALSE	Registration failed. 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.

Revision History

2006/12/12 Added description.
2006/11/09 Initial version.