DWC_SetAuthServer

C Specification

#include <dwc.h>

void DWC_SetAuthServer( DWCInetAuthType type );

Description

This function specifies the Nintendo server that authenticates the Nintendo Wi-Fi Connection ID that is set in the Nintendo DS and issues information to connect to the GameSpy server.

The development and production authentication servers are available.

Use the development authentication server during development and debugging; use the production authentication server when creating the final ROM. At the testing stage during development, do not use the production authentication server.

Further, when the development authentication server is specified, you cannot connect to the authentication server from a hotspot.

Call this function at the times indicated below to select the authentication server.

Before Connecting to the Internet

...
DWC_InitInet( &stConnCtrl );
DWC_SetAuthServer( DWC_CONNECTINET_AUTH_RELEASE ); // Call after DWC_InitInet().
...

Before Using Nintendo Wi-Fi Connection Setup

...
DWC_SetAuthServer( DWC_CONNECTINET_AUTH_RELEASE ); // Call before DWC_StartUtility().
DWC_StartUtility( ... );
...

Operation Status of the Authentication Server

To check the operation status of each authentication server, see the following links. If the character string "AuthServer is up" appears, the server is operating.

authentication server for products development authentication server

Arguments

type Sets what type of authentication server to use.

Specify the authentication server type as indicated below.

DWC_CONNECTINET_AUTH_TEST Uses the development authentication server. (default)
DWC_CONNECTINET_AUTH_RELEASE Uses the production authentication server.
DWC_CONNECTINET_AUTH_DEVELOP Used for developing the library. Do not use the application.

Return Values

None.

See Also

DWC_InitInet, DWC_ConnectInetAsync, DWC_CheckInet, DWC_ProcessInet, DWC_GetInetStatus, DWC_CleanupInet DWC_CleanupInetAsync

Revision History

12/16/2005 Added an explanation of DWC_CONNECTINET_AUTH_DEVELOP and the authentication server for development to the argument explanation.
07/22/2005 Initial version