DWC_CreateFriendKey

C Specification

#include <dwc.h>

u64 DWC_CreateFriendKey( const DWCUserData* userdata );

Description

Generates a friend registration key from the user data that will be exchanged with friends. Display the acquired friend registration key as a 12-digit base-10 numerical value.

In friend registration, after verifying the validity of the friend registration key entered by the user with the DWC_CheckFriendKey, create the friend data using the DWC_CreateFriendKeyToken function and add the created information to the friend roster.

Furthermore, assume that friend registration keys may sometimes be entered incorrectly; therefore, prepare an interface that allows users to reenter the friend registration key until it is accepted.

When the Nintendo Wi-Fi Connection has never been used, a friend registration key cannot be created, so make some kind of interface to create one after making a connection, or display a message with those instructions.

Arguments

userdata Pointer to the DWCUserData structure where user data is stored.

Return Values

positive value Friend registration key
0 Failed because the profile is not obtained.

See Also

DWC_CreateFriendKeyToken, DWC_CheckFriendKey

Revision History

2007/01/25 Added the method for verifying friend registration keys.
2005/12/16 Revisions.
2005/10/20 Initial version.


CONFIDENTIAL