SC_ErrorHandling

This file contains function specific errors and ways of handlings it.

SC_Client_New

SC_INVALID_ARGUMENT

Occurs when
  • One or more of the following arguments is NULL: pSelf, pInitData, gameIdentifier, gameSecret, gameVersion, currency

  • Version is not of format [0-9]+.[0-9]+

Recover by
  • Change your code so that function gets called with proper arguments.

SC_DEV_PERMISSION_DENIED

Occurs when
  • User declined to sign up to Scoreloop via Games app Wizard.

Recover by
  • Disable Scoreloop functionality in game. Add some UI to allow user to sign up to Scoreloop again (by calling SC_Client_New again).

SC_DISABLED_DUE_TO_CORPORATE_LIABLE_MODE

Occurs when
  • Device is set to corporate liable mode.

Recover by
  • Inform user and disable Scoreloop for your game. No need to give user a chance to retry as once device is in CL mode it will stay there.

SC_PAL_INITIALIZATION_FAILED

Occurs when
  • PAL related initialization arguments are wrong (SC_Init_Data fields)

  • Memory exhausted while setting up Platform Abstraction Layer (PAL)

  • Subsystems (e.g. BPS) could not initialized for unspecified reasons.

Recover by
  • Check your code if SC_Init_Data fields are correct. At runtime, disable Scoreloop functionality and/or try again later.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateScoreController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateScoresController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateRankingController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateMessageController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateChallengeController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateChallengesController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateUserController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateUsersController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateActivitiesController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateGamesController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateGameItemController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateGameItemsController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_Client_CreateAchievementsController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_AWARDS_BUNDLE_NOT_FOUND

Occurs when
  • Awards-bundle can not be found at expected place.

Recover by
  • Add awards-bundle file to project at correct correct place in sandbox.

SC_INVALID_AWARDS_BUNDLE

Occurs when
  • Format of awards-bundle (either the json or the strings files) is not correct.

Recover by
  • Check format of awards-bundle or download correct awards-bundle from Scoreloop developer portal.

SC_FILE_ERROR

Occurs when
  • Awards-bundle or parts of it can not be read.

Recover by
  • Check if awards-bundle and its subparts (json and strings files) have read permissions.

SC_Client_CreateLocalAchievementsController

SC_INVALID_ARGUMENT

Occurs when
  • Any argument other than the cookie is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_AWARDS_BUNDLE_NOT_FOUND

Occurs when
  • Awards-bundle can not be found at expected place.

Recover by
  • Add awards-bundle file to project at correct correct place in sandbox.

SC_INVALID_AWARDS_BUNDLE

Occurs when
  • Format of awards-bundle (either the json or the strings files) is not correct.

Recover by
  • Check format of awards-bundle or download correct awards-bundle from Scoreloop developer portal.

SC_FILE_ERROR

Occurs when
  • Awards-bundle or parts of it can not be read.

Recover by
  • Check if awards-bundle and its subparts (json and strings files) have read permissions.

SC_ScoreController_SubmitScore

SC_INVALID_ARGUMENT

Occurs when
  • Arguments self or score are NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_TOO_MANY_REQUETS_QUEUED

Occurs when
  • Too many requests are triggered (currently 128).

Recover by
  • Retry again after some back off time.

SC_ScoresController_SetMode

SC_INVALID_ARGUMENT

Occurs when
  • Argument self is NULL.

  • Argument mode is > SC_SCORE_MODE_MAX but not SC_SCORE_MODE_UNDEFINED.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_ScoresController_SetSearchList

SC_INVALID_ARGUMENT

Occurs when
  • Argument self is NULL.

  • Field countrySelector of searchList is SC_COUNTRY_SELECTOR_EXPLICIT but country field is NULL.

  • Field usersSelector of searchList is SC_USERS_SELECTOR_BUDDYHOOD but buddyhoodUser field is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted when copying country string.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_ScoresController_LoadScoresAtRank

SC_INVALID_ARGUMENT

Occurs when
  • Argument self is NULL.

  • Argument rank zero or negative.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_TOO_MANY_REQUETS_QUEUED

Occurs when
  • Too many requests are triggered (currently 128).

Recover by
  • Retry again after some back off time.

SC_LocalAchievementsController_SetValueForAwardIdentifier

SC_INVALID_ARGUMENT

Occurs when
  • Argument self is NULL.

  • Argument awardIdentifier is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_UNKNOWN_AWARD

Occurs when
  • No Award is found in awards-bundle for given awardIdentifier string.

  • Argument awardIdentifier is NULL.

Recover by
  • Verify that the awardIdentifier is spelled correctly and a corresponding award exists in the awards-bundle.

SC_INVALID_RANGE

Occurs when
  • Argument value is less then the initial value of the award.

  • Argument value is greater than the achieving value of the award.

Recover by
  • Only submit a value which is within the allowed values for the award.

SC_SYNCHRONIZATION_IN_PROGRESS

Occurs when
  • An achievement synchronization is still in progress.

Recover by
  • Either wait for the synchronization to finish or call SC_LocalAchievementsController_Cancel then retry again.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_FILE_ERROR

Occurs when
  • The local achievements database can not be written.

Recover by
  • Filesystem ran out of space. Delete some files then try again.

SC_LocalAchievementsController_Synchronize

SC_INVALID_ARGUMENT

Occurs when
  • Argument self is NULL.

Recover by
  • Change your code so that function gets called with proper arguments.

SC_OUT_OF_MEMORY

Occurs when
  • Memory gets exhausted.

Recover by
  • Disable Scoreloop functionality and/or again try later.

SC_TOO_MANY_REQUETS_QUEUED

Occurs when
  • Too many requests are triggered (currently 128).

Recover by
  • Retry again after some back off time.

Last modified: 2013-12-21

comments powered by Disqus