DWC_ConnectToGameServerAsync

Syntax

#include <dwc.h>

BOOL DWC_ConnectToGameServerAsync(
             int serverIndex,
             DWCMatchedSCCallback matchedCallback,
             void* matchedParam,
             DWCNewClientCallback newClientCallback,
             void* newClientParam );

Description

This function specifies and connects to the server DS that the friend roster index connected to. The server DS waits for a connection from a client DS after calling the DWC_SetupGameServer function in this server-client matchmaking. If DWC_ProcessFriendsMatch is called continuously after this function is called, the matchmaking process continues. If the matchmaking results in success, error, or cancellation, the matchmaking completion callback is called.

If a new client DS attempts to connect to the server DS after a connection with the server DS is established, a new connection client notification callback is called. Also, once the new connection client's connection operation has completed, the matchmaking end callback is called again.

Arguments

serverIndex Friend roster index on the destination server DS.
matchedCallback Pointer to the connection complete callback function. This is called for each person connected.
matchedParam Parameter for the connection completion callback.
newClientCallback The pointer to the new connection client notification callback function.
newClientParam Parameter for the new-connection client notification callback.

Return Values

TRUE The process starts. The results are indicated via the callback function.
FALSE Not a good state for calling this function.

See Also

DWC_SetupGameServer
DWC_SetupGameServerAsync
DWCMatchedSCCallback
DWCNewClientCallback
DWC_ProcessFriendsMatch

Revision History

2005/12/16 Described the function in detail. Corrected errors in Return Values.
2005/11/07 Revisions.
2005/07/22 Initial version.


CONFIDENTIAL