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

Syntax

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

Overloaded Member Functions

UpdateProgressScore ( ProtocolCallContext *, GatheringID, qUnsignedInt8 ) Updates the game progress score in a matchmaking session.
UpdateProgressScore ( GatheringID, qUnsignedInt8 ) Updates the game progress score in a matchmaking session.

Description of UpdateProgressScore ( ProtocolCallContext *, GatheringID, qUnsignedInt8 )

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.

Description of UpdateProgressScore ( GatheringID, qUnsignedInt8 )

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.


CONFIDENTIAL