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

Syntax

qBool UpdateProgressScore(
     ProtocolCallContext * pContext,
     GatheringID gid,
     qUnsignedInt8 progressScore
);

Parameters

Name Description
in pContext Call information.
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.

The following results may be returned as a result of asynchronous operation. Use the application to handle these results.

QERROR(RendezVous, SessionVoid): The matchmaking session does not exist.
QERROR(RendezVous, PermissionDenied): The caller is not the owner.
QERROR(Core, InvalidArgument): Game progress was set to a value higher than MAX_PROGRESS_SCORE.
QERROR(Core, InvalidSequence): The function was called at an interval shorter than UPDATE_PROGRESS_SCORE_MINIMUM_INTERVAL_TIME seconds.

Revision History

2014/04/08
Corrected QERROR(Core, InvalidArgment) to QERROR(Core, InvalidArgument) 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