qBool UpdateProgressScore( GatheringID gid, qUnsignedInt8 progressScore );
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 . |
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
.
ProtocolCallContext
is unnecessary and is handled internally.
QERROR(Core, InvalidArgment)
to QERROR(Core, InvalidArgument)
and QERROR(Core, GameServerMaintenance)
to QERROR(RendezVous, GameServerMaintenance)
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