DWC_ConnectInetAsync

Syntax

#include <dwc.h>
void DWC_ConnectInetAsync(void);

Arguments

None.

Return Values

None.

Description

Initiates an automatic connection process to the Internet. The automatic connection process checks for nearby access points, selects an appropriate one, and connects to it automatically. Access points are either configured by the setup utility (these can be normal or USB, at home or another location) or provided inside a retail store.

After calling this function, call the DWC_ProcessInet function roughly every game frame to execute the automatic connect process.

To process errors that occur during the autoconnect process, first call the DWC_ProcessInet function and then get the error status using the DWC_GetLastErrorEx function. If necessary, display an error code along with an error message. See the Nintendo Wi-Fi Connection Programming Guidelines for more information on error messages.

Get the connection status with the DWC_CheckInet or DWC_GetInetStatus function.

This function waits for a PXI interrupt for synchronization purposes. Do not call it when PXI interrupts are prohibited.

See Also

DWC_CheckInet DWC_CheckInet DWC_ProcessInet DWC_GetInetStatus DWC_CleanupInet

Revision History

5.4
Added mention that this function should not be called when PXI interrupts are prohibited.
5.1
Changed "while connected..." to "during the autoconnect process..."

For the change log before version 5.1 PR2, click here.  


CONFIDENTIAL