qBool StartRound( ProtocolCallContext * pCC, const MatchmakeRefereeStartRoundParam & param, qUnsignedInt64 * roundId );
Name | Description | |
---|---|---|
in | pCC | Call information. |
in | param | Start round parameter. |
out | roundId | Round ID. |
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)
.
MatchmakeRefereeStartRoundParam::SetPrincipalIds
function now returns QERROR(MatchmakeReferee, InvalidArgument)
rather than QERROR(PythonCore, Exception)
if duplicate principal IDs are specified.
CONFIDENTIAL