nn::nex::MatchmakeExtensionClient::UpdateProgressScore Member Function

Syntax

qBool UpdateProgressScore(
     GatheringID gid,
     qUnsignedInt8 progressScore
);

Parameters

Name Description
in gid The ID of the matchmaking session for which an attribute is to be changed.
in progressScore Specifies the game progress score. You can specify a value from 0 to MAX_PROGRESS_SCORE.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

Updates the game progress score in a matchmaking session.

Updates the game progress score in a matchmaking session. Only the owner of the matchmaking session can do this.

After calling this function for the first time, call it at an interval no shorter than UPDATE_PROGRESS_SCORE_MINIMUM_INTERVAL_TIME seconds. This function fails if it is called at an interval shorter than UPDATE_PROGRESS_SCORE_MINIMUM_INTERVAL_TIME seconds. However, the game progress can be updated at intervals less than UPDATE_PROGRESS_SCORE_MINIMUM_INTERVAL_TIME if it is set to 0 or MAX_PROGRESS_SCORE.

ProtocolCallContext is unnecessary and is handled internally.

Revision History

2014/04/08
Corrected QERROR(Core, InvalidArgment) to QERROR(Core, InvalidArgument) and QERROR(Core, GameServerMaintenance) to QERROR(RendezVous, GameServerMaintenance) in the description.
2014/03/28
Changed the function so that it returns QERROR(RendezVous, PermissionDenied) instead of success without doing anything when it is called by a station that is not the owner of the matchmaking session.
2013/05/20
Initial version.

CONFIDENTIAL