SC_LocalAchievementsController_SetValueForAwardIdentifier()

Sets the value of a local achievement.

Synopsis:

#include <scoreloop/sc_local_achievements_controller.h>
 
SC_DEPRECATED SC_PUBLISHED SC_Error_t SC_LocalAchievementsController_SetValueForAwardIdentifier(SC_LocalAchievementsController_h self, const char *awardIdentifier, int value, SC_Bool_t *pGetAchieved)

Since:

BlackBerry 10.0.0

Deprecated in BlackBerry 10.3.0

Arguments:

self

SC_LocalAchievementsController instance handle

awardIdentifier

The unique reverse DNS string chosen by the developer and used by Scoreloop to identify the award.

value

The value to which the award will be set. It can range between the initial value and the achieving value for the award. For anything above the range, value is set to the achieving value.

pGetAchieved

Returns SC_TRUE if calling the method results in the award being achieved by the user for first time. Otherwise SC_FALSE.

Library:

libscoreloopcore (For the qcc command, use the -l scoreloopcore option to link against this library)

Description:

This method is used to set the progress value of a specific award.

In order to reset the value for an unachieved award, SC_LocalAchievementsController_ResetValueForAwardIdentifier() should be used instead.

Returns:

SC_Error_t A return code (A value of SC_OK indicates success, any other value indicates an error. For more error codes see here).

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus