qBool UpdateProgressScore( ProtocolCallContext * pContext, GatheringID gid, qUnsignedInt8 progressScore );
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 . |
Value | Description |
---|---|
true |
Call initialization succeeded. |
false |
Failure. |
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.
QERROR(Core, InvalidArgment)
to QERROR(Core, InvalidArgument)
in the description.
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.CONFIDENTIAL