#include <dwc.h>
BOOL DWC_SVLGetTokenAsync(char *svl,
DWCSvlResult *result);| svl | 取得するサービスロケータ情報を指定するための4文字のASCII文字列(ヌル文字終端)。 通常は空文字を指定してデフォルトのサービスロケータ情報を取得してください。 |
| result | 取得したサービスロケータ情報を格納するDWCSvlResult型変数へのポインタ。 |
| TRUE | サービスロケータ情報取得処理を開始した。 |
| FALSE | サービスロケータ情報取得処理を開始できなかった。 |
任天堂認証サーバからサービスロケータ情報を取得する処理を開始します。この関数を呼び出した後、定期的にDWC_SVLProcess関数を呼び出すことで、サービスロケータ情報を取得する処理を進行させます。
引数svlを使って、取得するサービスロケータ情報を指定することができます。
本関数がFALSEを返した場合、DWCのエラーがセットされている場合があります。DWC_GetLastErrorEx関数でエラー状態を取得し、必要に応じてエラーメッセージとともにエラーコードを表示してください。
サービスロケータは、独自サーバを利用する際に使用します。独自サーバへ接続する前に、任天堂認証サーバから(サービスロケータ情報に含まれる)認証トークンを取得してください。独自サーバへ接続する際には、取得した認証トークンを独自サーバに送信し、独自サーバ側で送信元が任天堂認証サーバで認証されたものであることを確認します。
独自サーバの運用に関する詳細は「独自ゲームサーバ利用説明書」をご確認ください。本マニュアルでは、サービスロケータ機能の利用方法のみを扱っています。
サービスロケータの利用の流れは以下のようになります。
正しい認証トークンを取得するには、各ゲームアプリケーションに対応したマスターROM用のテンプレートファイルを組み込んでおく必要があります。
5.1pr2より前の変更履歴はこちら