DWC_CreateFriendKey

構文

#include <dwc.h>
u64 DWC_CreateFriendKey(const DWCUserData *userdata);

引数

userdata ユーザデータが格納されたDWCUserData構造体へのポインタ

返り値

正の値 友達登録鍵
0 プロファイルを取得していないため、失敗しました。

説明

ユーザデータから、相手に渡す友達登録鍵を生成します。この関数で取得した友達登録鍵を10進12桁の数値として表示してください。

友達登録では、ユーザが入力した友達登録鍵をDWC_CheckFriendKey関数で正当性を確認した後、DWC_CreateFriendKeyToken関数を用いて友達情報を作成し、作成した友達情報を友達リストに追加してください。

また、ユーザが入力した友達登録鍵が間違っていることも想定して、友達関係が成立するまでは、友達登録鍵を再度入力できるインタフェースを準備してください。

一度もWi-Fiコネクションに接続していない場合は、友達登録鍵を生成できませんので、接続してから生成するようなインタフェースを準備するか、その旨のメッセージを表示してください。

注意:DWC_CreateFriendKey関数は、NITRO-DWC3.0から友達登録鍵の正当性確認に使用されるチェック値の生成方法が変更されたため過去のバージョンのNITRO-DWCで生成した友達登録鍵と互換性がありません。特別な理由で過去の友達登録鍵を扱う必要がある場合は、DWC_CreateFriendKeyLegacy関数とDWC_CheckFriendKeyLegacy関数をご使用ください。

参照

DWC_CreateFriendKeyToken DWC_CheckFriendKey DWC_CreateFriendKeyLegacy

履歴

5.1pr2より前の変更履歴はこちら