#include <dwc.h>
typedef void (*DWCMatchedSCCallback)( DWCError error,
BOOL cancel,
BOOL self,
BOOL isServer,
int index,
void* param );
This function is called when only a connection has been established or when an error or cancellation occurs after the DWC_SetupGameServer or DWC_ConnectToGameServerAsync functions have been called. If an error occurs, the values of all arguments other than error and param are undefined.
This callback function can be set using DWC_SetupGameServer or DWC_ConnectToGameServerAsync.
error |
DWC error type For details, see DWC_GetLastErrorEx. |
cancel |
TRUE: A matchmaking cancellation was detected. FALSE: The matchmaking was a success or an error was detected. |
self |
TRUE: One's own DS has successfully connected to the server DS and its network, or the matchmaking was cancelled. FALSE: Another client DS successfully connected to the server DS and its network, or the matchmaking was cancelled. |
isServer |
TRUE: The server DS cancelled matchmaking. FALSE: The client DS has successfully connected to the server DS and its network or the matchmaking was cancelled. |
index |
Matchmaking was a success or the friend roster index of the cancelled host. Value is -1 if the host is not a friend or if self = TRUE. |
param |
Parameter for the callback specified by DWC_SetupGameServer or DWC_ConnectToGameServerAsync. |
self |
isServer |
Description |
|---|---|---|
| TRUE | TRUE | None. |
| TRUE | FALSE | One's own DS is the client DS, and the connection to the server DS and its network is successful. The index is -1. |
| FALSE | TRUE | None. |
| FALSE | FALSE | One's own DS is the server or client DS and another client DS successfully connected to the server DS and its network. The index is the friend roster index of that client DS. If not a friend, it is -1. |
self |
isServer |
Description |
|---|---|---|
| TRUE | TRUE | One's own DS is the server DS, and that DS has cancelled matchmaking. The index is -1. |
| TRUE | FALSE | One's own DS is the client DS, and that DS has cancelled matchmaking. The index is -1. |
| FALSE | TRUE | One's own DS is the client DS, and the server DS has cancelled matchmaking. The index is the friend list index of the server DS. |
| FALSE | FALSE | One's own DS is the client or server DS, and another client DS has cancelled matchmaking. The index is the friend roster index of that client DS. If not a friend, it is -1.
|
None.
DWC_SetupGameServer, DWC_ConnectToGameServerAsync, DWC_GetLastErrorEx
2006/08/24 Corrected a mistake listed under allowable argument combinations.
2005/12/16 Added a description about the callback configuration functions. Added a table of the values that the argument can take
2005/11/01 Initial version.
CONFIDENTIAL