1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows"> 8<title>DWC_SvlInit</title> 9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 10</head> 11 12<body> 13<a name="dwc__svl_8h_14d824a81ccf2edf203dd361766ec5f70"></a> 14<h1 align="left">DWC_SvlInit</h1> 15<h2>Syntax</h2> 16 17<dl> 18 <dd> 19<CODE>#include <dwc.h></CODE><BR> 20 <BR> 21 <PRE><CODE>BOOL <a href=DWC_SvlInit.html#dwc__svl_8h_14d824a81ccf2edf203dd361766ec5f70>DWC_SvlInit</a>(void);</CODE></PRE></dd> 22</dl> 23 24<h2>Arguments</h2> 25 26<p>None.</p> 27 28<h2>Return Values</h2> 29 30<TABLE border="1" width="100%"> 31 <TBODY> 32 33 <TR> 34<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD> 35<TD width="87%">Succeeded.</TD> 36 </TR> 37 38 <TR> 39<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD> 40<TD width="87%">Failed.</TD> 41 </TR> 42 43 </TBODY> 44</TABLE> 45 46<H2>Description</H2> 47<p>Initializes service locator. Before using a service locator, first call this function once.</p><p>This function calls the <CODE>NHTTPStartup</CODE> 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.</p><p><h3>Overview of Service Locator</h3></p><p>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.</p><p>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.</p><p>For details on the operation of original servers, please check the <I>Original Game Server Usage Manual</I>. This function reference only describes how to use the service locator feature.</p><p><h3>Process Flow of Service Locator</h3></p><p><orderedlist><li>Use the <a href=DWC_LoginAsync.html#dwc__main_8h_1ac1f7f301938afe8408be88dfa65f217><CODE>DWC_LoginAsync</CODE></a> function to connect to Nintendo Wi-Fi Connection.<br></li><li>Call the <a href=DWC_SvlGetTokenAsync.html#dwc__svl_8h_12a0851aad4e01e92f2b92d620bbd7699><CODE>DWC_SvlGetTokenAsync</CODE></a> function and start the process of getting service locator information from the Nintendo Authentication Server.<br></li><li>Periodically call the <a href=DWC_SvlProcess.html#dwc__svl_8h_16a454056c5426edf03fc0c513993e4f3><CODE>DWC_SvlProcess</CODE></a> 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.<br></li><li>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 <a href="DWCSvlResult.html"><CODE>DWCSvlResult</CODE></a> variable. Included in this information is the authentication token to be sent to the original server.<br></li><li>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.<br></li></orderedlist></p><p><B>Note:</B> This API can only be used with titles for which the Nintendo Wi-Fi Connection Original Server Application Form has been submitted.</p> 48 49<H2>Revision History</H2> 50<DL> 51 52<DT><para>1.4.12</DT> 53<DD>Added information specific to conflicts in NHTTP.</DD> 54 55<DT><para>1.4.15</DT> 56<DD>Added a note about submitting the Nintendo Wi-Fi Connection Original Server Application Form, and added a description of the procedure for using SVL.</DD> 57 58</DL> 59<hr><p>CONFIDENTIAL</p></body> 60</html> 61