#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より前の変更履歴はこちら