DWC_SvlInit

Syntax

#include <dwc.h>

BOOL DWC_SvlInit(void);

Arguments

None.

Return Values

TRUE Succeeded.
FALSE Failed.

Description

Initializes service locator. Before using a service locator, first call this function once.

This function calls the NHTTPStartup function internally. Avoid the overlapping use of NHTTP before and after the interval from the time the function is called to the time the token is obtained.

Overview of Service Locator

The ServiceLocator library is the library used when an original server is used. Before connecting to the original server, use the ServiceLocator library to get the authentication token (contained in the service locator information) from the Nintendo Authentication Server.

When connecting to the original server, send the obtained authentication token to the original server and have this original server confirm that the sender was authenticated by the Nintendo Authentication Server.

For details on the operation of original servers, please check the Original Game Server Usage Manual. This function reference only describes how to use the service locator feature.

Process Flow of Service Locator

  • Use the DWC_LoginAsync function to connect to Nintendo Wi-Fi Connection.
  • Call the DWC_SvlGetTokenAsync function and start the process of getting service locator information from the Nintendo Authentication Server.
  • Periodically call the DWC_SvlProcess function to advance the service locator process, and to check the value returned by the function to determine whether or not the process has ended.
  • Just as with the authentication process, Nintendo Authentication Server checks that the source of the service locator information request is valid and if so, returns the service locator information. After the service locator process completes, the service locator information obtained from Nintendo Authentication Server is stored in the DWCSvlResult variable. Included in this information is the authentication token to be sent to the original server.
  • Before connecting to the original server, send it the obtained authentication token and have it check whether or not the sender was authenticated by Nintendo Authentication Server.
  • Note: This API can only be used with titles for which the Nintendo Wi-Fi Connection Original Server Application Form has been submitted.

    Revision History

    1.4.12
    Added information specific to conflicts in NHTTP.
    1.4.15
    Added a note about submitting the Nintendo Wi-Fi Connection Original Server Application Form, and added a description of the procedure for using SVL.

    CONFIDENTIAL