Main Page | Modules | File List | File Members

The Callback typedefs

The typedefs for the callbacks. More...

Typedefs

typedef GSvoid(* MSClient_GameServerCB )(GSint iLobbyID, GSint iRoomID, GSshort siGroupType, GSchar *szGroupName, GSint iConfig, GSchar *szMaster, GSchar *szAllowedGames, GSchar *szGames, GSchar *szGameVersion, GSchar *szGSVersion, GSvoid *vpInfo, GSint iSize, GSuint uiMaxPlayer, GSuint uiNbrPlayer, GSuint uiMaxVisitor, GSuint uiNbrVisitor, GSchar *szIPAddress, GSchar *szAltIPAddress, GSint iEventID)
 The information on a Game Server.

typedef GSvoid(* MSClient_AlternateInfoCB )(GSint iLobbyID, GSint iRoomID, const GSvoid *pcAlternateInfo, GSint iAltInfoSize)
 The Alternate Info of a Game Server.

typedef GSvoid(* MSClient_ErrorCB )(GSint iReason, GSint iLobbyID, GSint iRoomID)
 An error occured.

typedef GSvoid(* MSClient_InitFinishedCB )(GSubyte ucType, GSint iError, GSchar *szUserName)
 The initialization has finished.

typedef GSvoid(* MSClient_LoginDisconnectCB )()
 The library has disconnected from the Router.

typedef GSvoid(* MSClient_LobbyDisconnectCB )()
 The library has disconnected from the Lobby.

typedef GSvoid(* MSClient_RequestFinishedCB )()
 All the Game Servers have been downloaded.

typedef GSvoid(* MSClient_JoinFinishedCB )(GSint iLobbyID, GSint iRoomID, GSvoid *vpGameData, GSint iSize, GSchar *szIPAddress, GSchar *szAltIPAddress, GSushort usPort)
 Finished joining the game server.

typedef GSvoid(* MSClient_AccountCreationCB )(GSubyte ucType, GSint iReason)
 Account Creatation callback.

typedef GSvoid(* MSClient_ModifyAccountCB )(GSubyte ucType, GSint iReason)
 Account Creatation callback.

typedef GSvoid(* MSClient_MatchStartedCB )(GSint iLobbyID, GSint iRoomID, GSuint uiMatchID)
 The match has started.

typedef GSvoid(* MSClient_SubmitMatchCB )(GSubyte ucType, GSint iReason, GSuint iMatchID)
 The replay to MSClient_SubmitMatchResult.


Detailed Description

These typedefs describe the callbacks functions. You use the Fix functions to tell the library what callback functions to use.

Typedef Documentation

typedef GSvoid( * MSClient_AccountCreationCB)(GSubyte ucType, GSint iReason)
 

Description:
Tells the client if the account creation was successfull.
Parameters:
ucType GSSUCCESS or GSFAIL
iReason The reason for a GSFAIL.

typedef GSvoid( * MSClient_AlternateInfoCB)(GSint iLobbyID,GSint iRoomID, const GSvoid* pcAlternateInfo, GSint iAltInfoSize)
 

Description:
This called when alternate information on a Game Server is received.
Parameters:
iLobbyID The ID of the Lobby Server
iRoomID The ID of the Room.
pcAltGroupInfo The alternate information
iAltInfoSize The size of the alternate info

typedef GSvoid( * MSClient_ErrorCB)(GSint iReason,GSint iLobbyID, GSint iRoomID)
 

Description:
Called when a error occurs. The reason can be looked up in LobbyDefine.h
Parameters:
iReason The reason for the error
iLobbyID The ID of the lobby. 0 if the error doesn't involve a Lobby
iRoomID The ID of the room. 0 if the error doesn't involve a Room

typedef GSvoid( * MSClient_GameServerCB)(GSint iLobbyID,GSint iRoomID, GSshort siGroupType,GSchar *szGroupName, GSint iConfig, GSchar *szMaster,GSchar *szAllowedGames,GSchar *szGames, GSchar *szGameVersion,GSchar *szGSVersion,GSvoid *vpInfo,GSint iSize, GSuint uiMaxPlayer,GSuint uiNbrPlayer,GSuint uiMaxVisitor, GSuint uiNbrVisitor,GSchar *szIPAddress,GSchar *szAltIPAddress, GSint iEventID)
 

Description:
This Callback is called for every Game Server that is found.
Parameters:
iLobbyID The ID of the Lobby Server
iRoomID The ID of the Room.
siGroupType The type of Game Server. (ROOM_DIRECTPLAY,ROOM_GAMEMODULE, ROOM_P2P,ROOM_CLIENTHOST)
szGroupName The name of the Server
iConfig The Server configuration flag
szMaster The name of the master of the room.
szAllowedGames The games allowed in this room.
szGames The games that can be played in the room.
szGameVersion The version of the game (information only)
szGSVersion The version of the gs-game
vpInfo A pointer to the game data
iSize The size of the game data structure
uiMaxPlayer The maximum number of players allowed in that room
uiNbrPlayer The number of players currently in that room
uiMaxVisitor The maximum number of visitors allowed in that room
uiNbrVisitor The number of visitors currently in that room
szIPAddress The ip address of the host (master) of the room
szAltIPAddress The alternate ip address of the host (master) of the room
iEventID The event id for that room

typedef GSvoid( * MSClient_InitFinishedCB)(GSubyte ucType, GSint iError, GSchar *szUserName)
 

Description:
The library has finished initializing and other functions can be called. If an error happened while initializing, the type will be GSFAIL and iError will contain the reason for the error. This value can be looked up in define.h
Parameters:
ucType GSSUCCESS or GSFAIL
iError The reason for the GSFAIL
szUserName The correct case of the players username.

typedef GSvoid( * MSClient_JoinFinishedCB)(GSint iLobbyID,GSint iRoomID, GSvoid *vpGameData,GSint iSize,GSchar *szIPAddress,GSchar *szAltIPAddress, GSushort usPort)
 

Description:
The library has finished joining the game server on the lobby.
Parameters:
iLobbyID The ID of the Lobby Server
iRoomID The ID of the Room.
vpGameData The Game data
iSize The size of the Game Data
szIPAddress The IP address of the game server
szAltIPAddress The Alternate address
usPort The Port of the game server

typedef GSvoid( * MSClient_LobbyDisconnectCB)()
 

Description:
The library has become disconnected from the Lobby. The client does not need to uninitialize and re-initialize the library. If the player was in a Game they will have to call MSClient_JoinGameServerByID and rejoin the GameServer. They do not have to disconnect from the game server, this should not interrupt the player while they play the game.

typedef GSvoid( * MSClient_LoginDisconnectCB)()
 

Description:
The library has become disconnected from the Router. The client should uninitialize and then re-initialize the library. If the player was in a Game they will have to call MSClient_JoinGameServerByID and rejoin the GameServer. They do not have to disconnect from the game server, this should not interrupt the player while they play the game.

typedef GSvoid( * MSClient_MatchStartedCB)(GSint iLobbyID,GSint iRoomID, GSuint uiMatchID)
 

Description:
The game server has started the match
Parameters:
iLobbyID The ID of the Lobby Server
iRoomID The ID of the Room.
uiMatchID The id of the started match

typedef GSvoid( * MSClient_ModifyAccountCB)(GSubyte ucType, GSint iReason)
 

Description:
Tells the client if the account modification was successfull.
Parameters:
ucType GSSUCCESS or GSFAIL
iReason The reason for a GSFAIL.

typedef GSvoid( * MSClient_RequestFinishedCB)()
 

Description:
Called when all the Game Servers have been downloaded. This is currently 3 seconds after the last Game Server has been received.

typedef GSvoid( * MSClient_SubmitMatchCB)(GSubyte ucType, GSint iReason,GSuint iMatchID)
 

Description:
Informs the program if the SubmitMatch was successful or not
Parameters:
ucType GSSUCCESS or GSFAIL
iReason if usType is GSFAIL this is the reason. See LobbyDefines.h
iMatchID The id of the match


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