nn::nex::MatchmakeRefereeClient::StartRound Member Function

Syntax

qBool StartRound(
     ProtocolCallContext * pCC,
     const MatchmakeRefereeStartRoundParam & param,
     qUnsignedInt64 * roundId
);

Parameters

Name Description
in pCC Call information.
in param Start round parameter.
out roundId Round ID.

Return Values

Returns the result of the operation.

Description

Starts the round.

The users specified with the MatchmakeRefereeStartRoundParam::SetPrincipalIds function are the participants in the round. Only gathering participants that were specified using the MatchmakeRefereeStartRoundParam::SetGatheringId function can be specified in the MatchmakeRefereeStartRoundParam::SetPrincipalIds function. After a round starts, round participants must call EndRound or EndRoundWithoutReport.
Round participants are notified with NotificationEvents::RoundStarted that the StartRound function has been called.

If empty or duplicate principal IDs are specified in the MatchmakeRefereeStartRoundParam::SetPrincipalIds function, this function returns QERROR(MatchmakeReferee, InvalidArgument).
If some of the users specified in the MatchmakeRefereeStartRoundParam::SetPrincipalIds function are not participants in the Gathering specified in the MatchmakeRefereeStartRoundParamSetGatheringId function, this function returns QERROR(MatchmakeReferee, NotParticipatedGathering).

Revision History

2014/09/24
The MatchmakeRefereeStartRoundParam::SetPrincipalIds function now returns QERROR(MatchmakeReferee, InvalidArgument) rather than QERROR(PythonCore, Exception) if duplicate principal IDs are specified.
2013/12/06
Initial version.

CONFIDENTIAL