#include <dwc.h>
BOOL DWC_LoginAsync( const u16 * ingamesn,
const char* reserved,
DWCLoginCallback callback,
void* param);
The application checks if the GameSpy server can be used, performs remote authentication, and connects to Nintendo Wi-Fi Connection.
To call this function, the DWC_InitFriendsMatch function must complete through FriendsMatch Library initialization after connecting to the internet. Continue to call the DWC_ProcessFriendsMatch function after this function is called and the login process will proceed. When the process is complete, the login completion callback will be called.
The authentication server checks to see if the in-game screen name (the name the player is using during the game) is inappropriate on the Wi-Fi connection. Get the results of that check with the DWC_GetIngamesnCheckResult function after successfully connecting to the Wi-Fi connection.
Be aware that an error communicating with the Authentication server (error code 20109) will be generated if the maker code is undefined in the data registered in ROM.
Also be sure to call the DWC_NASLoginAsync function in place of this one when not using the FriendsMatch Library.
ingamesn |
Screen name sent to the authentication server.
|
reserved |
Normally, specify NULL. Retained for compatibility with past versions. |
callback |
The pointer to the login completion callback function. |
param |
Parameter for the login completion callback. |
TRUE |
The login process starts. The results are indicated via the callback function. |
FALSE |
This is not a good time to call this function, or a NULL has been designated in the ingamesn argument. The callback function will not be called. |
DWC_InitFriendsMatch, DWC_ProcessFriendsMatch, DWC_ShutdownFriendsMatch, DWCLoginCallback, DWC_GetIngamesnCheckResult, DWC_NASLoginAsync
07/24/2006 Corrected errors
07/03/2006 Inserted an explanation in the function description about when the FriendsMatch Library is not in use
05/30/2006 Added cautionary notes about the maker codes for the ROM registration data
04/26/2006 Changed the length of the character string that can be designated for ingamesn and added a description
01/31/2006 Inserted the term "FriendsMatch Library" into the function description
12/16/2005 Added support for the addition of the screen name argument inside the game Corrected errors in Return Values.
07/22/2005 Initial version.
CONFIDENTIAL