DWC_SetAuthServer

Syntax

#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.

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

To select the authentication server, call this function at the times indicated below.

The server used for general-purpose ranking and downloads and the server for products and for development can be switched by using this function to switch the authentication server.

However, for managing friends, matchmaking and data storage, no distinction is made between the development and product servers.Since there is no distinction made between the development and product servers, there is a possibility of matchmaking with titles already sold on the market when testing matchmaking during development of the remastered or localized version, even if this function is used to set the authentication server for products.

To avoid this, it is necessary to make a distinction so that matchmaking is not performed with the product version or debug/development version based on conditions on the players to be searched as matchmaking candidates that can be specified when using peer matchmaking without friend specification.

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 Production Authentication Server for Development

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

2008/05/12 Added a note about the server for products and the server for development.
2008/01/16 Added a description about the server to be connected by the library when switching authentication servers.
2005/12/16 Added a description of DWC_CONNECTINET_AUTH_DEVELOP to the description of arguments and a description of the authentication server for development.
2005/07/22 Initial version.


CONFIDENTIAL