DWC_DebugConnectInetAsync

C Specification

#include <dwc.h>

void DWC_DebugConnectInetAsync( const void *ssid, const void *wep, int wepMode );

Description

Used for debugging in place of DWC_ConnectInetAsync, this function starts automatic connection to the Internet using AP settings specified by argument.
This process will only target an AP specified by the argument. The IP address is obtained using DHCP.
For further details about the WEP key, refer to the cautions "About the WEP Key" on the top page.

To perform the automatic connect process after calling this function, call the DWC_ProcessInet function every game frame.

To process errors that occur while connected, after calling the DWC_ProcessInet function, obtain the error status using the DWC_GetLastErrorEx function. If necessary, display an error code along with an error message. For creating this error messages, refer to the Nintendo Wi-Fi Connection Programming Guideline. If a connection error occurs while using this function, the last two digits of the error code will be '00'.

You can obtain connection status with the DWC_CheckInet or DWC_GetInetStatus function.

* Do not call with the DWC_SetConnectApType function.
* Although this function operates with the final ROM version (FINALROM), it was prepared for the sake of debugging, so in principle it should not be used in the commercial product.

Arguments

ssid SSID of the AP specified for the connection target.
Be sure to specify a string up to 32 bytes.
wep WEP key of the AP specified for the connection target
Specifies a pointer to a byte array having the specified length in wepMode.
Specify NULL when wepMODE is WCM_WEPMODE_NONE.
wepMode Mode of the WEP key of the AP specified for the connection target
WCM_WEPMODE_NONE Represents a type of encynption where WEP encryption is not performed WCM_WEPMODE_40 - Type of encryption that uses 40-bit (5-byte) WEP encryption.
WCM_WEPMODE_104 - Type of encryption that uses 104-bit (13-byte) WEP encryption.
WCM_WEPMODE_128 - Type type of encryption that uses 128-bit (16-byte) WEP encryption.

Return Values

None.

See Also

DWC_ConnectInetAsync, DWC_CheckInet, DWC_SetAuthServer, DWC_CheckInet, DWC_ProcessInet, DWC_GetInetStatus, DWC_CleanupInet, DWC_SetConnectApType

Revision History

04/27/2006 Added an explanation about the WEP key. Added precautions.
04/17/2006 Explained the relation to the DWC_ConnectInetAsync function.
03/10/2006 Initial version


CONFIDENTIAL