Main Page | Modules | Class List | File List | Class Members | File Members

Callbacks
[Login Service]

The login service function callbacks. More...

Typedefs

typedef GSvoid(* CBLoginRcv_PlayerInfo )(GSubyte ubType, GSchar *szUsername, GSchar *szSurName, GSchar *szFirstName, GSchar *szCountry, GSchar *szEmail, GSchar *szIRCID, GSchar *szIPAddress, GSint iReason)
 Receive information on a player.

typedef GSvoid(* CBLoginRcv_JoinWaitModuleResult )(GSubyte ubType, GSchar *szAddress, GSushort usPort, GSint iReason)
 Receive status of the join wait module request.

typedef GSvoid(* CBLoginRcv_LoginRouterResult )(GSubyte ubType, GSint iReason)
 Receive status of the login request.

typedef GSvoid(* CBLoginRcv_LoginWaitModuleResult )(GSubyte ubType, GSint iReason)
 Receive status of the login wait module request.

typedef GSvoid(* CBLoginRcv_SystemPage )(GSint iSubType, GSchar *szText)
 Received a system page.

typedef GSvoid(* CBLoginRcv_LoginDisconnection )()
 Disconnection from router.

typedef GSvoid(* CBLoginRcv_AccountCreationResult )(GSubyte ubType, GSint iReason)
 Receive the status of the account creation request.

typedef GSvoid(* CBLoginRcv_ModifyUserResult )(GSubyte ubType, GSint iReason)
 Receive the status of the user modifycation request.

typedef GSvoid(* CBLoginRcv_RequestMOTD )(GSubyte ubType, GSchar *szUbiMOTD, GSchar *szGameMOTD, GSint iReason)
 Receive the message of the day.


Detailed Description


Typedef Documentation

typedef GSvoid( * CBLoginRcv_AccountCreationResult)(GSubyte ubType, GSint iReason)
 

Description:
This callback will be called when the client receive a response from the router after sending a account creation request
Related Function:
LoginSend_Disconnect()
Errors:
ERRORSECURE_USERNAMEEXISTS: The account name already exists.
ERRORSECURE_USERNAMEMALFORMED: The account name does not match the format rules ^[a-zA-Z][a-zA-Z0-9_\.-]{2,14}$.
ERRORSECURE_USERNAMEFORBIDDEN: The account name contains forbidden substrings (e.g. smut)
ERRORSECURE_USERNAMERESERVED: The account name is reserved
ERRORSECURE_PASSWORDMALFORMED: The password does not match the format rules ^.{2,16}$.
ERRORSECURE_PASSWORDFORBIDDEN: The password contains the username
ERRORSECURE_DATABASEFAILED: There is a problem with the database.
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_JoinWaitModuleResult)(GSubyte ubType, GSchar *szAddress, GSushort usPort, GSint iReason)
 

Description:
This callback will be called when the client receive a response from the router after asking to join the wait module. The client should then call LoginSend_Connect() with this szAddress and usPort.
Related Function:
LoginSend_JoinWaitModule()
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
szAddress IP address of the wait module
usPort The port of the wait module
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_LoginDisconnection)()
 

Description:
This callback will be called when the client is disconnected from the router

typedef GSvoid( * CBLoginRcv_LoginRouterResult)(GSubyte ubType, GSint iReason)
 

Description:
This callback will be called when the client receive a response from the router after asking to log into the router. If you reveive a GSSCUCCESS you can then call LoginSend_JoinWaitModule().
Related Function:
LoginSend_LoginRouter()
Errors:
ERRORSECURE_DATABASEFAILED: There is a problem with the Database.
ERRORROUTER_NOTDISCONNECTED: The player is already logged in.
ERRORSECURE_INVALIDPASSWORD: The password is not correct.
ERRORSECURE_LOCKEDACCOUNT: The account has been locked.
ERRORSECURE_INVALIDACCOUNT: The username doesn't exist.
ERRORSECURE_BANNEDACCOUNT: The account has been banned.
ERRORSECURE_BLOCKEDACCOUNT: The account has been blocked.
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_LoginWaitModuleResult)(GSubyte ubType, GSint iReason)
 

Description:
This callback will be called when the client receive a response from the router after asking to login to the wait module. After receving this callback you will be fully connected to the Game Service. It's recommened that the client now call LoginSend_PlayerInfo() with the players username to get his szIRCID and the correct case of his username.
Related Function:
LoginSend_LoginWaitModule()
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_ModifyUserResult)(GSubyte ubType, GSint iReason)
 

Description:
This callback will be called when the client receive a response from the router after sending a user info modification request
Related Function:
LoginSend_ModifyAccount()
Errors:
ERRORSECURE_PASSWORDMALFORMED: The password does not match the format rules ^.{2,16}$.
ERRORSECURE_PASSWORDFORBIDDEN: The password contains the username
ERRORSECURE_DATABASEFAILED: There is a problem with the database.
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_PlayerInfo)(GSubyte ubType, GSchar *szUsername, GSchar *szSurName, GSchar *szFirstName, GSchar *szCountry, GSchar *szEmail,GSchar *szIRCID, GSchar *szIPAddress, GSint iReason)
 

Description:
This callback will be called when the client requests information on a player
Related Function:
LoginSend_PlayerInfo()
Errors:
ERRORROUTER_DBPROBLEM: There is a problem with the database.
ERRORROUTER_NOTREGISTERED: The username doesn't exist.
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
szUsername The username of the player in the correct case
szSurName The last name of a player
szFirstName The first name of the player
szCountry The country of the player
szEmail Email address of the player
szIRCID Player's IRC ID
szIPAddress Player's ip address
iReason The reason of failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_RequestMOTD)(GSubyte ubType, GSchar *szUbiMOTD, GSchar *szGameMOTD, GSint iReason)
 

Description:
This callback will be called when the client receives the MOTDs from the server. The messages will never be greater the MOTDLENGTH.
Related function:
LoginSend_RequestMOTD()
Errors:
ERRORROUTER_DBPROBLEM: There is a problem with the database.
Parameters:
ubType The status of the message received back (GSSUCCESS or GSFAIL)
szUbiMOTD The message of the day for the Ubi.com Game Service
szGameMOTD The message of the day for the game.
iReason The reason for the failure if ubType is GSFAIL

typedef GSvoid( * CBLoginRcv_SystemPage)(GSint iSubType, GSchar *szText)
 

Description:
This callback will be called when the client received a system page wich is usually called by a administrator or when another player adds the client to his friend list.
Parameters:
iSubType The type of message. The possibilities are:
  • ADDEDASFRIEND
    The player was added to the friend list of the other player who's name is in the szText parameter
  • ADDEDASIGNOREE
    The player was added to the ignore list of the other player who's name is in the szText parameter
  • REMOVEDASIGNOREE
    The player was removed from the ignore list of the other player who's name is in the szText parameter
szText The actual message


Ubi.com GameService SDK - ©UbiSoft Entertainment 2002
GameService development team