DWC_StopSCMatchingAsync

C Specification

#include <dwc.h>

BOOL DWC_StopSCMatchingAsync(DWCStopSCCallback callback,
                             void* param);

Description

Cancels the server-client matchmaking currently in process from the server DS, and blocks future connection requests from the client DS.

After cancellation occurs and subsequent connection requests from the client DS are set to be denied, a cancellation completed callback is called.

After the cancellation runs, the maximum number of connectable players is set to equal the number of currently connected players. As a result, no other client DS devices will be able to connect to this server.

Additionally, if connected players drop out after cancellation occurs, an equivalent number of client DS devices will be able to connect to the server DS.

Arguments

callback A pointer to the cancellation complete callback function
param Parameter used by the cancellation complete callback

Return Values

TRUE The server-client matchmaking cancellation succeeded.
FALSE The server-client matchmaking cancellation did not succeed.

See Also

DWCStopSCCallback

Revision History

02/23/2006 Initial version