#include <dwc.h>
void DWC_CreateExchangeToken( const DWCUserData* userdata, DWCFriendData* token );
This function uses one's own user data as specified in userdata
to create the friend information that is exchanged during DS wireless communication. The token created with this function is sent with DS wireless communication. The side which receives this token registers it in the friend roster as friend information.
When registering friend information in the friend roster, first check all the friend information on the roster using the DWC_IsEqualFriendData function to verify that the information does is not already registered to avoid duplicate data registration, then search for a location in the roster that does not contain valid data using DWC_IsValidFriendData and directly copy the obtained friend information to the friend roster at that location.
When you want to delete friend information from the friend roster, call the DWC_DeleteBuddyFriendData function. When offline, friend information is simply cleared with 0. The next time the DWC_UpdateServersAsync function is called, the friend-related information on the GameSpy server is deleted. When online, friend information is cleared with 0 and the friend-related information on the GameSpy server is deleted immediately.
The friend roster may sometimes automatically change while online, based on a request from a GameSpy server. To edit the friend roster while online, use the DWC_CanChangeFriendList function to check whether or not the list can be edited.
To establish friend relationship by editing the friend roster while online, use the DWC_UpdateServersAsync function.
userdata |
Pointer to the DWCUserData structure where user data is stored. |
token |
Pointer to the buffer that stores the friend information to send over DS wireless communication. |
None.
DWC_CreateFriendKeyToken , DWC_IsEqualFriendData, DWC_IsValidFriendData, DWC_DeleteBuddyFriendData, DWC_CanChangeFriendList, DWC_UpdateServersAsync
12/16/2005 Revisions.
10/26/2005 Revisions.
10/20/2005 Initial version.