DWCConnectAttemptCallback

Syntax

#include <dwc.h>
typedef BOOL(*) DWCConnectAttemptCallback(u8 *newClientUserData,
             void *param);

Arguments

newClientUserData Pointer to the buffer where newly connected clients store the value set in the connectionUserData parameter of the DWC_ConnectToAnybodyAsync, DWC_ConnectToFriendsAsync, DWC_SetupGameServer, DWC_ConnectToGameServerAsync, or DWC_ConnectToGameServerByGroupID functions. Must be of size u8[DWC_CONNECTION_USERDATA_LEN].
param Callback parameter.

Return Values

TRUE Accepts new connection clients.
FALSE Denies new connection clients.

Description

At the final stage of deciding on a new client's participation, this callback is called to determine the application's decision. (This callback is not called if the group is full or in acceptance denied state.) When deciding whether to accept new connection clients, you should consider two types of user data: the connection user data of new connection clients, obtained from the newClientUserData parameter, and the connection user data of already-connected clients, obtained using the DWC_GetConnectionUserData function. If a client tries to connect using DWC_ConnectToGameServerAsync or DWC_ConnectToGameServerByGroupID and FALSE is returned when this function is called by the server, DWC_ERROR_SC_CONNECT_BLOCK is set as an error on the client side.

Revision History

For the changelog prior to 5.1 PR2, click here.


CONFIDENTIAL