DWC_ConnectToGameServerAsync

C Specification

#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 is the DS that waits for a connection from a client DS after calling the DWC_SetupGameServer function in this server-client matchmaking. If the DWC_ProcessFriendsMatch function is continually called after calling this function, the matchmaking process will continue. The matchmaking completion callback will be called if the matchmaking results in a success, an error, or a cancellation.

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

12/16/2005 Added a detailed description of the function. Corrected a notation error in the return value.
11/07/2005 Revised version.
07/22/2005 Initial version.