qBool UpdateProgressScore( ProtocolCallContext * pContext, GatheringID gid, qUnsignedInt8 progressScore ); qBool UpdateProgressScore( GatheringID gid, qUnsignedInt8 progressScore );
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. |
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.
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